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PREFACE 


his Guide explains how to install and use the ORACLE Relational 

Database Management System (ORACLE RDBMS) under the DOS 
and OS/2 environments. Although this Guide contains information on 
both DOS and OS/2, this package contains only software for DOS or 
OS/2, depending on which product you purchased. The purposes of 
this Guide are to: 


* introduce you to the ORACLE Database software in the DOS 
and OS/2 environments 
e help you install or upgrade your ORACLE Database software 


e provide information that is specific to using the ORACLE 
Database under DOS and OS/2 
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Audience 


Prerequisites 


How This Guide is 
Organized 


Whether you are a user of database applications or a programmer who 
writes database applications, this Guide is your roadmap to the 
ORACLE Database. 


You should be familiar with your computer and its operating system. 
For example, you should know the commands for deleting and 
copying files, and understand the concepts of the search path, 
subdirectories, and pathnames. You should also know how to make 
simple changes to an ASCII file with a text editor. 


Part I of this Guide introduces the ORACLE Database and discusses the 
requirements for operating ORACLE software under DOS and OS/2. 
Part I also discusses the procedures for installing a new ORACLE 
database or upgrading your Version 5.1 database to Version 6.0. 


Part II of this Guide discusses the procedures for administering the 
ORACLE Database. It also explains how the ORACLE Database and 
SQL*Loader software operate differently under the DOS and OS/2 
environments as compared to other operating systems. You can use 
Part II as a supplement to the ORACLE RDBMS Database Administrator's 
Guide and the ORACLE RDBMS Utilities User's Guide. These Guides 
present information about the ORACLE RDBMS and ORACLE utilities 
under all operating systems. 


Part III of this Guide contains reference information on ORACLE 
Database limitations under DOS, and on error messages under DOS 
and OS/2. 
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Notational 
Conventions 


The following typographical conventions are used in this Guide: 


Monospace text 


Italics 


u 


Punctuation 


UPPERCASE 


E> 


[EAN] 


\DIRECTORY 


Enter text exactly as shown. Text typed on a PC is 
not case-sensitive unless otherwise noted. 


Italics represent a parameter. Substitute an 
appropriate value. 


Brackets enclose optional items or indicate a 
function key. Do not enter the brackets themselves. 


A vertical bar represents an “or” option between 
several options. You must enter one, and only one 
of the options separated by the vertical bar. Do not 
enter the vertical bars. 


Punctuation other than brackets, braces, and vertical 
bars must be entered in commands exactly as shown. 


Uppercase characters in the text represent 
command names. 


C> represents the DOS prompt of the hard disk 
drive you are using. Your prompt may differ and 
may, at times, reflect the subdirectory in which 
you are working. The C> prompt is also used in 
examples that apply to both OS/2 and DOS. 


[C:\] represents the OS/2 prompt of the hard disk 
drive you are using. Your prompt may differ and 
may, at times, reflect the subdirectory in which 
you are working. 


A backslash before a directory name indicates that 
this directory is a subdirectory. 


This symbol indicates that the material that follows 
applies only to the DOS operating system. 


This symbol informs you that the material that 
follows applies only to the OS/2 operating system. 
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Definitions of 
Special Terms 


A Note on 
Directory Names 


A Note on DOS 


Your Comments Are 
Welcome 


In this Guide, the word “database” has several different meanings, 
depending on its context. 


ORACLE RDBMS is the ORACLE Relational Database Management 
System. The ORACLE RDBMS is a software 
program that runs under many different Operating 
systems and enables you to access and manipulate 
data in ORACLE database files. 


ORACLE Database is the name of the ORACLE RDBMS that runs 
under DOS or OS/2. Its full name is either 
“ORACLE Database for DOS” or “ORACLE 
Database for OS/2”. 


ORACLE database is a collection of files created by the ORACLE 
RDBMS running under any operating system. 


This Guide assumes that all directory names are those given by the 
default installation procedures. Thus, the ORACLE home directory is 
assumed to be \ORACLE6, the ORACLE program directory is 
assumed to be \ORACLE6\BIN, and so forth. If your system is set up 
to use different directory names, substitute those names for the ones 
shown in this Guide. 


When you encounter the term “DOS” in this Guide, it refers to either of 
two similar personal computer Operating systems, as follows: 


+ MS-DOS Version 3.31 or later, from Microsoft 


e DR DOS Version 6.0 or later, from Digital Research 
International 


For the purposes of the ORACLE Database, these two variants of DOS 
are identical. 


We value and appreciate your comments as an ORACLE user and 
reader of the manuals. As we write, revise, and evaluate, your 
opinions are the most important input we receive. At the back of this 
manual is a Reader's Comment Form. We encourage you to use this 
form to tell us what you like and dislike about this (or other) Oracle 
manuals. If the form is missing, or if you would like to contact us, 
write us at the following address, or call us at 415.506.7000. 


ORACLE Database Product Manager 
Desktop Products Division 

Oracle Corporation 

500 Oracle Parkway 

Redwood Shores, CA 94065 
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I GETTING STARTED 








CHAPTER 


INTRODUCTION TO 
THE ORACLE 
DATABASE 


his chapter provides a general overview of the ORACLE Database 
for DOS and OS/2 and its components. This chapter also discusses 
the ORACLE Database product set. 
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EET) 
The ORACLE Database 


1-2 


The ORACLE Database is a relational database management system 
(RDBMS). The ORACLE Database stores large amounts of information 
and keeps it ready for instant use or update. The system’s design 
utilizes two-dimensional tables to store data, and it allows you to 
define relationships between items within a table and items in different 
tables. 


The ORACLE Database is accessed via a non-procedural query 
language called Structured Query Language, or SQL (pronounced 
“sequel”). With SQL you can retrieve, insert, update, and delete data, 
add new tables to the database, protect private data, and more. Asa 
beginning user, you can issue individual SQL statements through an 
interactive interface such as SOL*Plus. As an application programmer, 
you can embed these same, powerful SQL statements in a procedural 
language such as C, COBOL, or FORTRAN. You can also use SQL to 
access the ORACLE Database via a fourth-generation language 
product, such as SQL*Forms. 


ORACLE runs on many different hardware platforms, including 
mainframe computers, minicomputers, and microcomputers. The 
ORACLE Database products for DOS and OS/2 are single-user 
versions of the RDBMS. However, they contain essentially the same 
functionality as ORACLE databases Operating on other operating 
systems and hardware platforms. 


Since ORACLE database software contains the same functionality on 
most computers on which it runs, much of the product documentation 
applies to ORACLE as it operates under all operating systems. For 
example, the ORACLE RDBMS Database Administrator's Guide included 
with this package is the same version included with ORACLE software 
on a minicomputer or mainframe. This Installation and User's Guide, 
however, provides specific information about using ORACLE Database 
for DOS and ORACLE Database for OS/2. 
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AAA ATA 
ORACLE Database Product Set 


ORACLE Database 
Utilities 


SQL*Loader 


The ORACLE Database product set is available for both DOS and 
OS/2. The following are included in the ORACLE Database package. 
Note that you can also purchase a package containing the ORACLE 
tools without the ORACLE Database. 


Note: Many additional software tools are available for accessing the 
ORACLE Database. Contact your Oracle sales representative for 
information about additional ORACLE software. 


The ORACLE Database product includes utilities for performing 
administrative tasks such as backing up and restoring data, and for 
enhancing the performance of your database. It also includes utilities 
for tasks such as loading data into the ORACLE Database from 
ordinary ASCII files. The ORACLE Database utilities include: 


SQL*DBA Helps you perform administrative procedures, 
which are discussed in Chapter 5 of this manual. 

EXP Exports data from the database to a file. 

IMP Imports data that was exported by EXP. 

TKPROF Helps you tune your ORACLE Database. 


SQL*Loader is an application-development tool for placing existing 
data into tables in an ORACLE database. SQL*Loader loads data in a 
variety of formats, including ASCII, dBASE III PLUS, and Lotus 1-2-3. 
SQL*Loader also performs filtering (the selective loading of records 
based upon certain data values) and loads multiple tables 
simultaneously. 
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ORACLE Tools 


1-4 


The following application tools are included with the ORACLE Tools 


for DOS and OS/2 product. These tools must be purchased separately 
as a bundle, and are not included with the database utilities and 
products listed on the previous page. 


SQL*Plus 


SQL*ReportWriter 


SQL*Forms 
SQL*Menu 


Client Manager 
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SQL*Plus is the interactive SQL interface 
application tool. With SQL*Plus you can use SQL 
statements to create and delete tables, and actas a 
database administrator. You can access the 
database interactively to edit, format, and print 
reports, and to store and retrieve queries. 


SQL*ReportWriter is a powerful, menu-driven 
report generation program that allows you to 
create single- and multi-query reports in complex 
and versatile formats. 


SQL*Forms is an interactive program for designing 
and using form-based applications. 


SQL*Menu is a menu-generation program for 
creating full-featured, end-user menus. 


Client Manager is an integrated application 
development environment that enables you to 
access ORACLE tools and utilities through 
drop-down menus and windows. Client Manager 
is easy to customize by adding your own tools and 
utilities to the existing menus. 











CASAS 
ORACLE Database Package Contents 


Your ORACLE Database for DOS or OS/2 package should contain the 
documentation and software described below. 


Documents provided for the ORACLE Database: 
+ ORACLE Database for DOS and OS/2 Installation and User's Guide 
(this Guide), Part No. 9027-60-0392 


e ORACLE RDBMS Database Administrator’s Guide, 
Part No. 3601-V6.0 


e ORACLE RDBMS Utilities User's Guide, Part No. 3602-V6.0 


e ORACLE RDBMS Error Messages and Codes Manual, 
Part No. 3605-V6.0 


° ORACLE RDBMS Performance Tuning Guide, Part No. 5317-V6.0 
e PL/SQL User's Guide and Reference, Part No. 800-V1.0 
System disks for the ORACLE Database for DOS: 
e DOS Install 
e DOS Required Support Files 
e Windows Required Support Files 
e DOSSQL*Loader 
e DOS Utilities 
e DOS RDBMS 
System disks for the ORACLE Database for OS/2: 


e OS/2 Install 
e OS/2 Required Support Files 
e OS/2SQL*Loader 
e OS/2 Utilities 
e OS/2 RDBMS 
If your package is not complete, refer to your ORACLE PC Products 


Customer Information booklet for information on contacting Oracle 
Customer Support. 
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CHAPTER 


ORACLE DATABASE 
REQUIREMENTS 


his chapter discusses the hardware and software requirements for 

ORACLE Database for DOS and ORACLE Database for OS/2. It 
also discusses the memory and disk-space requirements for the 
ORACLE Database and ORACLE utilities. 
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CA A 
Hardware and Software Requirements for DOS 


TABLE 2-1 

Memory and Disk-Space 
Requirements 

(in Kilobytes) 


The following list specifies the hardware and software requirements for 
running the ORACLE Database for DOS. All requirements are subject 
to change without notice. 


° an IBM, COMPAQ, or 100-percent compatible PC 

* a minimum of 3.5 megabytes (Mb) of extended memory. You 
will need additional extended memory in order to run the 
database and one or more of the ORACLE tools 
simultaneously. 


Note: Table 2-1 provides a breakdown of memory and 
disk-space requirements. 


e a minimum of 10.3 Mb of hard disk space for the database and 
database software. This disk space is in addition to the space 
required by any ORACLE tools you wish to install. 

° one 5.25 inch, double-sided, high-density disk drive or one 3.5 
inch, double-sided disk drive 


e MS-DOS Version 3.31 or later, or DR DOS Version 6.0 or later 








Memory Disk Space 
Mode Product Required (K) Required (K) 
Real ORACLE 28! N/A 
SQL*DBA 425 318 
SQL*Loader 254 827 
SQLPME 41-68 41 
IMP 330 215 
EXP 350 247 
TKPROF 400 195 
Protected ORACLE 2,500 9,200 
SQLDBA 425 308 
SQL*Loader 450 812 
SQLPME N/A N/A 
IMP 330 206 
EXP 350 238 
TKPROF 400 203 
In addition to protected-mode requirements. 
Psee the following section, “ORACLE Memory Management Software,” for more information on 


SQLPME memory requirements. 


Note: Refer to the ORACLE Tools for DOS and OS/2 Installation and 
User's Guide for information on the requirements for ORACLE tools. 
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ORACLE and DOS 
Memory 


ORACLE 
Memory-Management 
Software 


There are three types of memory used in the DOS environment: real, 
extended, and expanded. The characteristics of each memory type are 


as follows: 


Real Memory 


Extended 
Memory 


Expanded 
Memory 


Also referred to as “real mode,” real memory is the 
standard memory used by DOS. Real memory is 
limited to a maximum of 640K. Most ORACLE 
products cannot operate in real mode. Note, 
however, that many ORACLE products require at 
least a portion of real-mode memory 

(see Table 2-1). 


Also referred to as “protected mode,” extended 
memory is memory above the 640K limit set by 
DOS. Extended memory is accessed directly by an 
80286, 80386, or 80486 processor Operating in 
protected mode. ORACLE Database for DOS 
Operates in protected-mode memory. 


As with extended memory, expanded memory can 
be thought of as memory above the 640K limit set 
by DOS. You can “configure” available memory as 
expanded memory by using a third-party 
memory-management program. The ORACLE 
Database software cannot operate in memory 
configured as expanded memory. 


Although DOS limits the memory space available to run programs to 
640K, ORACLE extends this limit with SQLPME. SQLPME, the SQL 
Protected-Mode Executive, is a memory-management program that 
loads the ORACLE Database and ORACLE tools into extended 
memory. SQLPME is copied to your hard disk when you install the 
DOS Required Support Files disk (see Chapter 3). 


You load SQLPME when you start the ORACLE Database using the 
“ORACLE” command described in Chapter 5 of this Guide. You can 
also start SQLPME alone by typing: 


C> SQLPME [-s] 
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ORACLE and Expanded 
Memory Managers 


ight 


The optional commmand-line parameter, “-s”, tells SQLPME to skip 
the designated number of kilobytes of memory immediately above 1 
megabyte. For example, 


C> SQLPME -s1024 


loads SQLPME at the 2 Mb segment inmemory. You can use the “-s” 
option in combination with the DYNAMIC_MEMORY parameter 
(described in Chapter 9) to load ORACLE products into a designated 
portion of extended memory. Note that the “-s” option is 
case-sensitive. 


The amount of memory that SQLPME requires is proportional to the 
value of the CONFIG.ORA parameter, GDTSIZ, which is described in 
Chapter 9 of this Guide. For example, if GDTSIZ is set to 5,000 bytes, 
SQLPME requires 41K. If GDTSIZ is set to 20,000 bytes, SOLPME 
requires 56K. If you are using a VCPI-compatible memory manager 
with SQLPME, SQLPME requires 56K and 68K (respectively) for these 
same GDTSIZ settings. Refer to the following section for a discussion 
of VCPI-compatible memory managers. 


Some programs, such as Lotus 1-2-3, can use “expanded memory” to 
work with data. You configure available memory as expanded 
memory by using a third-party memory-management program. 


The ORACLE Database software cannot operate in memory configured 
as expanded memory. However, it can operate in conjunction with 
several different industry standard memory-management products 
that comply to the Virtual Control Program Interface (VCPI) standards 
for memory managers. Such memory-management products include 
Quarterdeck's QEMM, COMPAQ’s CEMM (Version 4.01 and later 
only), and Qualitas’ 386MAX. 


If you wish to use a third-party memory manager with ORACLE 
products, you must specify this during the installation. When you 
install the Required Support Files disk in the next chapter, select your 
memory-management program name as the machine type. For 
example, select “Quarterdeck” if you are using Quarterdeck’s QEMM 
program. If your memory manager is not listed as an option during the 
installation, check to see if the program meets the VCPI standard. If the 
program is VCPI-compatible, select “VCPI” as your machine type. 


Follow the installation instructions in Chapter 3 for more information 
about selecting your machine type. 
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SS A] 
Hardware and Software Requirements for OS/2 


0S/2 


TABLE 2-2 

OS/2 Disk-Space 
Requirements 
(in Kilobytes) 


The following list specifies the hardware and software requirements for 
running ORACLE Database for OS/2. All requirements are subject to 


change without notice. 


e an IBM, COMPAQ, or 100-percent compatible PC 
e a minimum of 8 megabytes (Mb) of RAM 


* a minimum of 7 Mb of free hard disk space. This disk space is 


in addition to the space required by any ORACLE tools you 
wish to install. 


Note: See Table 2-2 for a breakdown of disk-space requirements. 


e one 5.25 inch, double-sided, high-density disk drive or one 3.5 


inch, double-sided disk drive 
° IBM, Microsoft, or compatible OS/2, Version 1.1 or later 





Product Disk-space Required 
ORACLE 4500 

SQL*DBA 500 

SQL*Loader 278 

IMP 80 

EXP 132 

TKPROF 81 


Note: See the ORACLE Tools for DOS and OS/2 Installation and User's 
Guide for information on the requirements for ORACLE tools. 
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CERA 
Requirements for Upgrading to ORACLE Database Version 6.0 


2-6 


If you are upgrading a Version 5.1 database you must have enough 
hard disk space to hold ORACLE Database Version 6.0 and your 
current ORACLE Database. ORACLE Database Version 6.0 requires 
10.3 megabytes of hard disk space under DOS, and 7 megabytes under 
05/2. 


Refer to Chapters 3 and 4 for more information about upgrading to 
ORACLE Database Version 6.0. 


ORACLE Database Installation and User’s Guide 








CHAPTER 


INSTALLING THE 
ORACLE DATABASE 


his chapter explains how to install the ORACLE Database under 
DOS or 05/2. Specifically, this chapter discusses: 


installation procedures 
the ORACLE directory structure 
upgrading to ORACLE Database Version 6.0 


modifying the CONFIG.SYS and AUTOEXEC.BAT files 
installation errors 


other installation tasks 


Installing the ORACLE Database 


Sie 
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Installation Overview 


Reinstalling or 
Upgrading ORACLE 
Database Software 


Installing ORACLE 
Database Version 6.0 


Before installing any ORACLE products, review the following 
documentation for any limitations or restrictions that may apply to 
your system: 


* the Release Notes, if any, delivered with your ORACLE 
Database package 


e Appendix A of this manual, “Unique DOS and OS/2 
Limitations” 


Note: Data on the installation disks is compressed; follow the 
installation instructions in this chapter to install the programs. 


If you are reinstalling ORACLE Database Version 6.0 you should back 
up your database before installing the new software. The installation 
can create a new database, destroying the data in your old database. See 
“Before You Install” later in this chapter for more information on 
backing up the database. 


If you are upgrading from a Version 5.1 database, you should install 
ORACLE Database Version 6.0 in a separate directory. To successfully 
upgrade your database, you must have ORACLE Database Version 6.0 and 
your original Version 5.1 database on your hard disk. After you have 
finished installing the Version 6.0 software, continue with Chapter 4, 
“Upgrading to ORACLE Version 6.0.” 


The installation procedure has two main parts. First, the installation 
prepares your system to receive the ORACLE programs. This 
preparation involves creating the ORACLE directories and modifying 
your CONFIG.SYS and AUTOEXEC.BAT (DOS only) files. 


Second, after rebooting your system, you install individual program 
sets from the ORACLE Database product. You should install the 
ORACLE Database Utilities and ORACLE Database before installing 
any ORACLE tools that you may have licensed. 
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ORACLE Directory 
Structure 


FIGURE 3-1 
\ORACLE6 Directory Structure 


The ORACLE installation procedure creates a default directory named 
\ORACLE6 under the root directory. It also creates subdirectories in 
the \ORACLES directory to hold the files associated with different 
parts of ORACLE, as shown in Figure 3-1. 


| Root Directory 


\ORACLE6 





BIN ) | \PBIN E \DBS ) 1LOADER] | \DLL ) omer ) 


) DOS only 
| ) 0812 only 











\BIN Holds executable programs and batch files for the 
ORACLE Database and ORACLE tools. 

\PBIN Holds the protected-mode executables for the 

(DOS only) ORACLE Database and ORACLE tools. 

\DBS Holds the files that contain the database 


information, as well as several types of associated 
data files and parameter files. 


\LOADER Holds files used by the SQL*Loader utility. 

\DLL Holds the dynamic-link libraries required by the 

(OS/2 only) ORACLE Database for OS/2. 

\OTHER Other directories hold files used by other ORACLE 
products. For example, \SRW is installed with 
SQL*ReportWriter. 


You can change certain directory names and locations. Refer to 
Chapter 9 in this Guide for further information. 
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a | 
Installing ORACLE Software 


Before You Install 


Back Up Your ORACLE 
Disks 


Back Up Your ORACLE 
Database 


To install the ORACLE Database, you first run the ORACLE 
installation program, ORAINST. ORAINST itself requires 
approximately 200K of RAM to run. However, you may need 
approximately 470K of RAM to start the database during the ORACLE 
installation. Therefore, if you get an error during the installation, you 
may need to press Q to Quit and then remove any utilities or TSR 
(terminate-and-stay-resident) programs that are currently running. 


ORAINST modifies your CONFIG.SYS and AUTOEXEC.BAT files 
(DOS only), if needed. If you wish, you can modify these files on your 
own. ORAINST also installs a copy of itself onto your hard disk during 
the installation. You can use this copy of ORAINST to: 


* install new ORACLE products 
* install update disks 

e list installed products 

* remove products 


For example, you run ORAINST from your hard disk to install the 
Required Support Files, the ORACLE Database Utilities, and the 
ORACLE Database software itself. 


The installation procedure is essentially the same for both DOS and 
OS/2. Margin symbols and notes within the text alert you to any 
differences. If you have a problem during the installation, refer to the 
section, “If You Receive an Installation Error,” near the end of this 
chapter. 


To protect your ORACLE software, make backup copies of all diskettes 
using the DISKCOPY command. See your operating system’s reference 
manual for information on the DISKCOPY command. Do not use the 
COPY command to make backups; it will not copy disk volume labels. 
Label the copies carefully and put them in a safe place. 


If you are reinstalling ORACLE Database Version 6.0, back up your database 
to prevent loss of information. To back up your database, use the EXP 
utility to export your data to a file. Copy this file to a safe place, such 
as removable media or a hard disk that will not be used during the 
installation. After you have reinstalled the ORACLE software, re-load 
your Version 6.0 data. See the ORACLE RDBMS Utilities User's Guide 
for information on the IMP and EXP utilities. 
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Installation Steps 


Step 1 
Run ORAINST 


Step 2 

Specify Drives and 
ORACLE Home 
Directory 


Insert the disk labeled Install in your disk drive (drive A: in this 
example) and enter ORAINST; or, if your system has a monochrome or 
grayscale monitor, use the MONO command-line option with the 
ORAINST command: 


C> A:ORAINST [MONO] 


The brackets around MONO indicate a command-line option. Do not 
type the brackets. 


You can receive help during the installation by pressing [F1]. 


Warning: Do not attempt to copy the contents of the floppy disks to 
your hard disk directly; the files on these disks are compressed. 
Always use the ORAINST command to de-compress them and perform 
other installation-related activities. Also, use ORAINST Version 2.1.0.3 
or later to load files on to your hard disk. The latest version of 
ORAINST is included on the Install disk. 


ORAINST prompts you to enter the following information: 


e the drive from which you will install the ORACLE products 

e the drive and directory (path) in which you will install the 
ORACLE products 

e the drive from which you boot (this prompt appears only when 
installing ORACLE products for the first time) 


Type in the appropriate drives and directories, or press [Enter] to 
accept the default values. ORAINST creates the specified directories if 
they do not already exist. 


Ifyou are upgrading from an earlier version of the ORACLE Database, you 
can install the new version in a separate directory. This will ensure that 
your existing database is not destroyed during the installation. If you 
install into a separate directory, however, be sure that you have 
sufficient disk space available. 
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Step 3 


National Language 
Support Installation 


Step 4 


Modify the 
CONFIG.SYS File 


Step 5 


Modify the 
AUTOEXEC.BAT File 


3-6 


DOS 


When you run ORAINST, it will verify that the LANGUAGE 
parameter has been set in CONFIG.ORA. If LANGUAGE is not set, a 
screen will appear with a list of available languages. Using the arrow 
Keys, highlight the language in which you would like your message 
files to appear, then press [Enter]. The installation procedure will 
then copy the appropriate language's message files. 


To change the installed language, modify the LANGUAGE parameter, 
then reinstall all products. Refer to Chapter 9 of this Guide, 
“Customizing Operating-System Parameters: The CONFIG File” for 
more information about modifying the LANGUAGE parameter. 


Notes: The value of the LANGUAGE parameter in your CONFIG.ORA 
file should match that of the LANGUAGE parameter in your 

INIT.ORA file. Refer to Chapter 10 for information about modifying 
the INIT.ORA file. In addition, refer to the ORACLE RDBMS Database 
Administrator's Guide for a discussion of INIT.ORA parameters. 


The default setting for LANGUAGE is American. 


ORAINST looks for a CONFIG.SYS file on the boot disk you specified 
in Step 2. If no CONFIG.SYS file exists, ORAINST automatically 
creates one for you. Ifan existing CONFIG.SYS file requires 
modifications, ORAINST prompts you to modify the file. Press 
[Enter] to accept the automatic modifications or highlight “No” and 
press [Enter] to modify the CONFIG.SYS file manually. 


If you select “No,” ORAINST creates a CONFIG.NEW file that contains 
the required modifications. Follow the instructions under “Modifying 
the CONFIG.SYS File” later in this chapter to modify your 
CONFIG.SYS file manually. Do this before continuing with the 
remaining steps. 


ORAINST looks for an AUTOEXEC.BAT file on the boot disk you 
specified in Step 2. ORAINST automatically creates an 
AUTOEXEC.BAT file if necessary, or appends the required commands 
to your existing AUTOEXEC.BAT file. Press [Enter] to accept the 
automatic modifications or highlight “No” and press [Enter] to 
modify the file manually. 


If you select “No,” a sample file with the proper modifications is 
created with the name AUTOEXEC.NEW. Follow the instructions 
under “Modifying the AUTOEXEC.BAT File” later in this chapter to 
modify AUTOEXEC.BAT manually. Do this before continuing with 
the remaining steps. 
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Step 6 
Reboot the Machine 


Install the Required 
Support Files 


Step 7 
Run ORAINST from Your 
Hard Disk 


Step 8 
Choose an Installation 
Task 


Step 9 
Insert the Required Support 
Files Disk 


Step 10 
Select a Hardware Model 
or Memory Manager 


DOS 


If the installation procedure made changes to your operating system's 
initialization files, you are prompted to reboot your machine. Remove 
the Install disk from the disk drive and reboot your system. 


Skip this step if you were not required to reboot your computer; 
otherwise, run ORAINST from your hard disk by typing: 


C> ORAINST [MONO] 


Again, you are prompted to specify the drive from which you will 
install products and the directory in which you will install products. 
Press [Enter] twice to accept the default settings. 


Choose “Install Product” from the list of installation tasks. Press 
[Enter] to make this selection. 


Insert the appropriate Required Support Files disk into the disk drive and 
press [Enter]. Use the disk labelled “DOS” or “OS/2,” depending on 
the version of the software you purchased. 


Notes: If you are installing ORACLE Database for DOS, do not use the 
disk labelled “Windows Required Support Files.” This disk is for use 
with the Pro*C precompiler, which is not included with ORACLE 
Database. See your Pro*C for DOS and OS/2 Getting Started for details. 


ORAINST copies special message files to your hard disk. ORAINST 
also copies the SQLPME utility (with ORACLE Database for DOS) or 
the Dynamic Link Libraries (with ORACLE Database for OS/2). 


SQLPME (the SQL Protected-Mode Executive) must know which 
hardware model or memory-management program you are using. 
Press [Enter] to display a list of hardware models and memory 
managers. 


Read the two sections below to determine your machine type. 
Afterwards, use the arrow keys to highlight your hardware model or 
memory-management program, and press [Enter] to select. 


Note: Should you need to change your machine type after installing 
ORACLE products, you can run the MACHTYPE utility from the DOS 
prompt by typing: 


C> MACHTYPE 
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Hardware Models 

Scroll through the list of hardware and software products to find your 
computer model. Some hardware models offer several possible choices 
and are marked by a (?) in the Machine Type field. When you select 
these models, a submenu of computers is displayed. For example, 
selecting COMPAQ displays a sub-menu of COMPAQ models. 


As you scroll through the list of hardware and software, note the 
number or letter in the Machine Type field. The machine type 
generally indicates the hardware model’s CPU. Thus, some of the 
models have the same machine type. For example, most 80386-based 
hardware models are machine type 2; most 80286-based hardware 
models are machine type 0. 


If you do not find your hardware model in the list, try selecting a 
machine type that most closely corresponds to the CPU of your 
hardware. You can also press [Esc] to move the cursor into the 
Machine Type field and enter the number or letter of your machine 
type directly. 


Memory-Management Programs 

If you are using a third-party memory-management program, it is not 
necessary to select a hardware model as your machine type. Simply 
select the name of your memory-management program from the list; 
for example, select “Quarterdeck” if you use Quarterdeck’s QEMM 
program. 


If your memory-management program is not listed, consult the 
program's documentation to determine if the software is “VCPI 
compatible.” If it is, select “VCPI” from the list of machine types. 
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Install the Database 
Utilities 


Step 11 
Choose an Installation 
Task 


Step 12 
Insert the Utilities Diskette 


Step 13 
Select Mode(s) of 
Operation 


DOS 


Step 14 


Acknowledge the 
SQL*DBA Message 


DOS 


When ORAINST returns to the “ORACLE Product Installation Main 
Menu,” choose “Install Product” from the list of installation tasks. 
Press [Enter] to make this selection. 


Insert the disk labeled Utilities Disk 1 into the disk drive and press 
[Enter]. 


If you are installing under OS/2, ORAINST copies the EXP, IMP, and 
SQL*DBA utilities to your hard disk. If the directory you are installing 
to contains Version 5.1 utilities, ORAINST prompts you to rename the 
older programs to V5EXP and V5IMP. 


ORAINST prompts you to install the utilities for use in protected mode 
only, real mode only, or both real and protected modes. Use the arrow 
keys to select the desired mode(s) of Operation and press [Enter]. 


ORAINST copies the SQL*DBA, EXP, IMP, and TKPROF utilities into 
the BIN and/or PBIN directories, depending on which modes you 
select. If the directory you are installing to contains Version 5.1 
utilities, ORAINST prompts you to rename the older utilities to V5EXP 
and V5IMP. 


ORAINST displays a series of steps to perform if your SOL*DBA 
monitor screens do not display properly. Acknowledge this message 
by pressing [Enter]. Ifyou need these instructions ata later time, 
refer to Chapter 5, “Administering Your System.” 

ORAINST finishes copying the utilities and returns to the “ORACLE 
Product Installation Main Menu.” 
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Install the Database 


Step 15 
Choose an Installation 
Task 


Step 16 
Insert the ORACLE 
RDBMS Disk 


Step 17 
Select to Install the Initial 
Database 


Step 18 
Enter a Password for DBA 
Commands 


While still running ORAINST, select “Install Product” from the list of 
installation tasks. 


Insert the disk labeled RDBMS Disk 1 into the disk drive and press 
[Enter]. 


ORAINST prompts you to install the RDBMS software only, the initial 
database only, or both the RDBMS software and the initial database 
files. If you are installing the ORACLE Database for the first time, you 
should elect to install both the RDBMS software and the initial database. 
The initial database contains sample data and user accounts to help 
you start using the ORACLE Database software. See Chapter 6 of this 
Guide for more information on the initial database. 


If you are reinstalling ORACLE Database Version 6.0 and you wish to 
preserve your existing data files, install the “RDBMS software only.” 
You may also elect to install the “RDBMS software only” if the initial 
database does not meet your needs. Such a situation might occur if you 
are upgrading a Version 5.1 ORACLE Database and need to import 
large amounts of data. See Chapter 6 of this Guide for a description of 
the initial database and procedures for creating customized database 
files. 


ORAINST prompts you to enter a DBA authorization password. Enter 
a password of at least six characters in length. If you are installing the 
RDBMS software, retype the password for verification. You must 
know this password in order to invoke SQL*DBA system-privileged 
commands. Should you forget the authorization password, you will 
have to reinstall the ORACLE RDBMS software. Refer to Chapter 5 of 
this Guide for more information on system-privileged commands. 


If you are installing the ORACLE Database for DOS, ORAINST adds 
your new authorization password to the CONFIG.ORA file as the 
value of the DBA_AUTHORIZATION parameter. This means that you 
do not have to supply the password to perform privileged DBA 
commands. If, however, you wish to maintain the security of your 
DOS database, you should remove the DBA_AUTHORIZATION 
parameter from your CONFIG.ORA file after installation. Refer to 
Chapter 5 for more information. 
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Step 19 
Exit ORAINST 


Step 20 
Perform Initial Database 
Administration 


Install SOL*Loader 
(Optional) 


Step 1 
Run ORAINST from Your 
Hard Disk 


Step 2 
Choose an Installation 
Task 


Step 3 
Insert the SOL*Loader 
Disk 


Step 4 
Select Mode(s) of 
Operation 


DOS 


Step 5 
Exit ORAINST 


ORAINST returns to the “ORACLE Product Installation Main Menu.” 
Select “Exit Install” to terminate ORAINST. 


If you installed the initial database in Step 17, follow the directions in 
Chapter 5 of this Guide to change the passwords of the SYS and 
SYSTEM users. 


If you wish to install SQL*Loader and its related utilities, follow the 
instructions below. Some of the SQL*Loader utilities are discussed in 
Chapter 11 and Appendix C of this Guide. 


Run ORAINST by typing: 
C> ORAINST [MONO] 
You are prompted to specify the drive from which you will install 


products and the directory in which you will install products. Press 
[Enter] twice to accept the default settings. 


Choose “Install Product” from the list of installation tasks. Press 
[Enter] to make this selection. 


Insert the disk labeled SQL*Loader into the disk drive and press 
[Enter]. 


If you are installing under OS/2, ORAINST copies SQL*Loader and its 
utilities to your hard disk. 


ORAINST prompts you to install SQL*Loader and its utilities for use in 
protected mode only, real mode only, or both real and protected 
modes. Use the arrow keys to select the desired mode(s) of operation 
and press [Enter]. 


ORAINST copies SQL*Loader and its utilities into the BIN and/or 
PBIN directories, depending on which modes you select. 


ORAINST returns to the “ORACLE Product Installation Main Menu.” 
Select “Exit Install” to terminate ORAINST. 
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AAA 
Modifying the CONFIG.SYS File 


DOS 
Modifications 


DOS 


OS/2 
Modifications 


Os/2 | 


If you chose to modify the CONFIG.SYS file manually (Step 4, 
“Installation Steps”), set the parameters as explained in the following 
sections. Note that you can use the sample CONFIG file, 
CONFIG.NEW, as a guideline when working with CONFIG.SYS. 
CONFIG.NEW is copied to your hard disk during the ORACLE 
installation. 


When installing ORACLE Database for DOS, you must set 3 different 
parameters to the appropriate values. These parameters are as follows: 


1. Modify the FILES command to read “FILES=40". 
2. Modify the BUFFERS command to read “BUFFERS=16”. 
3. Modify the BREAK command to read “BREAK=ON”, 


If you are installing ORACLE Database for OS/2, make the following 
modifications to your CONFIG.SYS file. 


1. Modify the BUFFERS command to read “BUFFERS=30". 


2. Modify LIBPATH to include \ORACLE6\DLL. For example, if the 
old LIBPATH is set to C:\, change it to: 


LIBPATH=C : \ORACLE6\DLL;C: \ 
3. Set PRIORITY to ABSOLUTE if it is not set already. 
PRIORITY=ABSOLUTE 


4. If your CONFIG.SYS file has a PATH command, add 
C:\ORACLE6\BIN to it. The position of C:\ORACLE6\BIN in the 
PATH command is not critical, but if you plan to use ORACLE 
software extensively, you may wish to put it at the beginning of the 
path. 


3-12 ORACLE Database Installation and User’s Guide 

















For example, change: 
SET PATH=C:\0S2;C:\WP;C:\ 
to: 
SET PATH=C: \ORACLE6\BIN;C: \082;C: \WP;C:\ 
If your CONFIG.SYS file does not have a PATH command, add the 
proper command to the file. For example: 
SET PATH=C: \ORACLE6\BIN 
- Use the SET CONFIG command in your CONFIG.SYS file to specify 


your CONFIG.ORA file. For example, if you are installing 
ORACLE products in the default directory on drive C:, add the line: 


SET CONFIG=C: \ORACLE6 \CONFIG.ORA 


If you are not installing ORACLE software in this directory, 
substitute your drive and directory in the SET CONFIG command. 
For example, if you are installing ORACLE software in 
\ORATEMP on drive D:, add the line: 


SET CONFIG=D: \ORATEMP\CONFIG.ORA 


The CONFIG variable is described in more detail in Chapter 9 of 
this Guide, “Customizing Operating System Parameters: The 
CONFIG file.” 
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EA 
Modifying the AUTOEXEC.BAT File 


If you chose to modify the DOS AUTOEXEC.BAT file manually (Step 5, 
DOS “Installation Steps”), set the parameters as follows. 
Note: You can use the AUTOEXEC.NEW file as a guide when working 


with AUTOEXEC.BAT. AUTOEXEC.NEW is copied to your hard disk 
during the installation. 


1. 
2. 


Q 


If you do not have an AUTOEXEC.BAT file, create one. 


If the AUTOEXEC.BAT file has a PATH command, add 
C:\ORACLE6\PBIN;C:\ORACLE6\BIN to it. The position of 
C:\ORACLE6\ PBIN;C:\ORACLE6\BIN in the PATH command is 
not critical, but if you plan to use ORACLE products extensively, 
you may wish to put it at the beginning of the path. For example, 
change: 


PATH=C: \BAT;C:\DOS;C:\WP;C: \ 

to 

PATH=C: \ORACLE6\PBIN;C: \ORACLE6\BIN;C:\BAT;C: \DOS;C:\WP;C:\ 
Note: If you plan to install applications for use in both real and 
protected mode, yet run them primarily in real mode, place the 


\BIN subdirectory before \PBIN in the PATH command. This will 
ensure that you run the real-mode versions of applications. 


If your AUTOEXEC.BAT file does not have a PATH command, add 
the proper command to the file. For example, 


PATH=C: \ORACLE6\PBIN;C: \ORACLE6\BIN;C: \DOS;C:\ 


. Use the SET CONFIG command in your CONFIG.SYS file to specify 


your CONFIG.ORA file. For example, if you are installing 
ORACLE software in the default directory on drive C:, add the line: 


SET CONFIG=C: \ORACLE6 \CONFIG.ORA 
If you are not installing ORACLE software in this directory, 
substitute your drive and directory in the SET CONFIG command. 


For example, if you are installing ORACLE products in 
\ORATEMP on drive D:, add the line: 


SET CONFIG=D: \ORATEMP\CONFIG.ORA 


The CONFIG variable is described in more detail in Chapter 9 of 
this Guide, “Customizing Operating System Parameters: The 
CONFIG file.” 
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If You Receive an Installation Error 


There are four common reasons for installation errors: 


You may not have enough memory to run the ORAINST 
utility. If you get an error during the installation, remove any 
utilities or TSR (Terminate and Stay Resident) programs that 
are currently running. ORAINST requires approximately 200K 
of RAM. However, you may need approximately 470K of 
RAM to start the database during the installation process. 


If you edited the CONFIG.SYS and AUTOEXEC.BAT (DOS 
only) files on your own, the modifications may be in error. Use 
the TYPE command to display each file on the screen and 
visually confirm that the changes specified in Steps 4 and 5 
were made successfully. 

Your system may not meet the ORACLE Database hardware or 
software requirements. Refer to Chapter 2 of this Guide for a 
complete list of requirements. 


If you are installing under DOS, you may have selected an 
incorrect hardware model or memory manager while installing 
the Required Support Files. Use the MACHTYPE utility to 
select a different hardware model or memory-management 
program. Refer to the previous section, “Install the Required 
Support Files” for more information on MACHTYPE. 
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Installing Update 
Disks 





Listing Installed 
Products 


| Removing Installed 
| Products 





a Se SS) 
Performing Other Installation Tasks 


The installation utility includes three installation tasks in addition to 
“Install Product.” These tasks are described in the following sections. 


Note: Update disks are clearly labelled as such. You should use the 
following procedures only with disks labelled “Update Disk.” 


To install an update disk, run ORAINST and select “Install Update 
Disk” from the “ORACLE Product Installation Main Menu.” Insert the 
first update disk and press [Enter] to continue with the installation. 
ORAINST copies files to the appropriate directory or prompts you to 
answer installation questions. 


When you have finished updating your product, substitute the update 
disk for the corresponding disk in your ORACLE product set. Use this 
disk in all future installations of that product. 


To list the products currently installed on your system, run ORAINST 
and select “List Installed Products” from the “ORACLE Product 
Installation Main Menu.” ORAINST displays the names and version 
numbers of all the products you have installed. 


To remove an ORACLE product from your hard disk, run ORAINST 
and select “Remove Product” from the “ORACLE Product Installation 
Main Menu.” ORAINST displays a list of products installed on your 
hard disk. Use the arrow keys to highlight the product you wish to 
remove and press [Enter]. 


Removing a product in this manner deletes all the files associated with 
a product from your hard disk. Removing a product does not delete a 
product's tables from the database. 


Note: The “Remove Product” option cannot remove versions of the 
ORACLE Database prior to Version 5.1C. 
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CHAPTER 





UPGRADING TO 
ORACLE 
VERSION 6.0 


his chapter describes the procedures for upgrading from ORACLE 

Database Version 5.1 to Version 6.0. This chapter uses the term 
“Version 5.1” to refer to any Version 5.1, 5.1A, 5.1B, or 5.1C database 
running under DOS or OS/2. If ORACLE Version 6.0 is your first 
installation of the ORACLE Database, skip this chapter. 


Note: This chapter assumes that you have installed a Version 6.0 database 
in a new directory on your hard disk. If you did not yet install Version 
6.0, follow the instructions in the previous chapter. 
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Overview 


FIGURE 4-1 
Procedures for Upgrading 
Your Database 


Before you upgrade from ORACLE Database Version 5.1, you should 
become familiar with the new architecture and terminology of ORACLE 
Version 6.0. Specifically, you should read the following topics in the 
ORACLE RDBMS Database Administrator's Guide before upgrading: 


° Appendix A presents an overview of the differences between 
ORACLE Version 5.1 and Version 6.0. 


* Chapters 3 discusses the operating-system files required to 
support a Version 6.0 Database. These files have changed from 
Version 5.1. 


* Chapter 4 describes the logical organization of a database. In 
particular, it describes tablespaces and segments. 


* Chapter 5 introduces the new terminology and data structures 
that are basic to understanding ORACLE Version 6.0. 


You may also refer to Chapter 5 of this Guide for information about the 
Version 6.0 SQL*DBA utility. After you are familiar with ORACLE 
Version 6.0, you can begin upgrading your Version 5.1 database. Figure 
4-1 outlines the steps needed to upgrade your database. 
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A TON] 
Section I: Prepare the Version 5.1 Database 


DOS Example 


OS/2 Example 


Back up Your Data 


Rename Conflicting 
Database Objects 


Section I discusses the procedures for preparing your Version 5.1 
Database for export to Version 6.0. You should follow these procedures 
before working with the installed Version 6.0 database. 


To ensure that you perform the following procedures on your Version 5.1 
database, you must set the CONFIG, PATH, and LIBPATH (OS/2 only) 
environment variables. When you install the Version 6.0 ORACLE 
Database, the installation program changes these variables to point to 
your new ORACLE subdirectories. You should reset these variables to 
point to your Version 5.1 subdirectories before following the procedures 
in this chapter. Substitute the directory names in the examples below 
with the directory names for your system. 


C> SET CONFIG=C: \ORACLE5 \CONFIG.ORA 
C> SET PATH=C: \ORACLE5\BIN;C: \ORACLE5 \PBIN 


(C:\] SET CONFIG=C: \ORACLE5\CONFIG.ORA 
[C:\] SET PATH=C: \ORACLE5\BIN 
For OS/2, also set the following parameter in CONFIG.SYS and reboot: 


LIBPATH=C: \ORACLE5\LIB 


Back up your Version 5.1 data. You should store this data on one of the 
following: 


e a series of floppy diskettes 
e anon-ORACLE directory on your hard disk 


Because you will modify your Version 5.1 database, it is crucial that you 
perform this step. The exported data is your only backup should you 
make a mistake during the steps that follow. 


User database objects may cause conflicts in a Version 6.0 database for 
two reasons: 


1. Object names may contain ORACLE Version 6.0 keywords. Refer to 
Chapter 3 of the SQL Language Reference Manual for a complete list of 
ORACLE keywords. 


2. Objects may share the same name for a given owner. ORACLE Version 6.0 
requires that indexes, clusters, tables, views, and synonyms have 
distinct names for a given owner. (In Version 5.1, only tables, views, 
and synonyms must have distinct names for a given owner.) 
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If any of your database Objects meet either of these criteria, rename them 
to avoid conflicts. To determine whether tables, clusters, views, or 

synonyms meet these criteria, connect to your Version 5.1 database with 
DBA privileges and issue the following SQL statement (using SQL*Plus): 


SQL> SELECT TABSNAME, TABSTYPE, USRSNAME FROM SYS.TABLES, 
SYS. USERAUTH WHERE TABSOWNER = USR$UID; 


To determine whether indexes meet these criteria, enter the SQL 
statement: 


SQL> SELECT IDX$NAME, USRSNAME FROM SYS. INDEXES, SYS. USERAUTH 
WHERE IDX$OWNER = USRSUID; 


These statements display a complete list of user database objects along 
with the username of each object’s owner, 


Prepare for Version 6.0 ORACLE Database Version 6.0 introduces a new database structure called 
Tablespaces a tablespace. Database administrators can use tablespaces in a number of 
(Optional) different ways. For example, a DBA might control users’ access to data 


If you wish to take advantage of tablespaces in your Version 6.0 database, 
you can use two different methods. Use Method 1 to place individual 
tables into designated tablespaces. Method 1 provides greater flexibility 
for using a large number of tablespaces. However, Method 1 requires that 
you recreate your Version 5.1 tables. 


Use Method 2 to place all tables from an individual user account into a 
single tablespace. Method 2 is more convenient if you have a large 
number of tables in your database. However, Method 2 requires that you 
export data from each of your user accounts, 


Note that each method requires that you create new tablespaces in your 
Version 6.0 database. Refer to “Create New Tablespaces” in Section II for 
more information. 


If you do not wish to store your Version 5.1 data in multiple Version 6.0 
tablespaces, skip the following sections, 
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Method1 To store tables in multiple Version 6.0 tablespaces, first create the 
corresponding partitions in your Version 5.1 database. Afterwards, 
recreate tables in the new partitions. Follow the steps below for more 
details. 


Note: If you currently store your Version 5.1 data in separate partitions, 
and you wish to have these partitions correspond to Version 6.0 
tablespaces, skip this section. 


1. Create new partitions in your Version 5.1 database. These partitions 
should have the same names as the Version 6.0 tablespaces you wish 
to use. To create a new Version 5.1 partition, connect to SQL*Plus 
with DBA privileges and type: 


SQL> CREATE PARTITION partition_name; 


2. Create new space definitions for each partition created in Step 1. This 
will allow you to transfer tables to specific partitions in the following 
step. To create a new space definition, type: 


SQL> CREATE SPACE DEFINITION space_name PARTITION partition_name; 


3. Transfer your data into the desired partitions. Do this by re-creating 
tables using the space definition for the new partition. For example, 
type 
SQL> CREATE TABLE new_table AS 

SELECT * FROM old_table SPACE space_name; 


where space_name is the space definition for the partition in which you 
want to place your table. 


4. After you have re-created the table in the desired partition, drop the 
original table using the following statement: 


SQL> DROP TABLE old_table; 


5. When you prepare your Version 6.0 database in Section II of this 
chapter, be sure to create tablespaces corresponding to the new 
partitions you made in Step 1. Refer to “Create New Tablespaces” in 
Section II for more information. 
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Method2 Tostoreallofa user's tables in a designated Version 6.0 tablespace, first 
export the user's Version 5.1 data. Modify the Version 6.0 tablespace 
structure and user account, and import the Version 5.1 data. Refer to the 
steps below for more details. 


Note that this method is only valid for users who do not have DBA 
privileges. 


1. Make sure that the Version 5.1 user does not possess DBA privileges. 
If the user has DBA privileges, revoke them with the statement: 


SQL> REVOKE DBA FROM username; 
2. Export the user’s data with the Version 5.1 EXP utility: 
C> EXP Username /password 


3. Perform all of the modifications outlined in Section II of this chapter, 
“Prepare the Version 6.0 Database.” Be sure to create the Version 6.0 
tablespace into which you will place this user’s data. Refer to “Create 
New Tablespaces” in Section II for more information, 


4. Create the user’s new account in the Version 6.0 database. 
SOLDBA> GRANT privileges TO username IDENTIFIED BY Password; 


5. Alter the user’s default tablespace to the new tablespace you created; 
type 
SQLDBA> ALTER USER username DEFAULT TABLESPACE tabl espace_name; 
where tablespace_name is the desired destination. 

6. Import the user’s Version 5.1 data using the Version 6.0 IMP utility: 


C> IMP username/password FILE=filename FULL=y 


where filename is the user's Version 5.1 EXP file. The data is stored in 
the user's default tablespace. 


7. Repeat these steps for each Version 5.1 user. 
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Record Partition 
Storage Space 
(Optional) 


Drop the 
Data Dictionary 


Export the Database 


To import data into Version 6.0 tablespaces most efficiently, you should 
note the amount of data contained in each of your Version 5.1 partitions. 
You can use this information in Section II to increase the sizes of Version 
6.0 tablespaces, if necessary. Follow the steps below to compute the 
storage space used in each partition. 


Note: These steps assume you have run the Version 5.1 CATALOG.ORA 
SQL script. CATALOG.ORA creates the tables and views required for 
checking database storage in your database. 


1. Determine the total disk space allocated to each partition in your 
database. To do this, connect to the database with DBA privileges 
and issue the following statement: 


SQL> SELECT 1024*SUM(ORABLOCKS), PNAME FROM PARTITIONS 
GROUP BY PNAME; 


2. Run the Version 5.1 CHKDBS utility to determine the amount of free 
space in each partition: 


C> CHKDBS dba_username dba_password 


3. Subtract the free space available in each partition from the total disk space 
allocated. This yields the total amount of storage space per partition, 
measured in bytes. Record this information for use in the next section. 


Since you will use the new data dictionary tables installed with ORACLE 
Version 6.0, drop your Version 5.1 data dictionary. To drop the data 
dictionary, log in to SQL*Plus with the SYSTEM username and password, 
and execute the DROPCAT5.SQL script. Note that the DROPCAT5.SQL 
script is installed with ORACLE Version 6.0. 


C> SOLPLUS SYSTEM/system_password 
SQL> @c:\ORACLE6\DBS\DROPCATS.SQL 


If you installed the ORACLE software in a different directory, substitute 
the appropriate path to DROPCAT5.SOL. 


When you have completed the preparations described above, export your 
full Version 5.1 database: 


C> EXP SYSTEM/system_password 


The EXP utility displays a number of prompts used to determine the 
extent of your export. Refer to the ORACLE RDBMS Utilities User’s Guide, 
Version 5.1, for information about using the EXP utility. 


Inform your users that they will be receiving new passwords; they will 
not be able to log in to the new database until you re-create their accounts. 
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SEE 


Section II: Prepare the Version 6.0 Database 


DOS Example 


OS/2 Example 


Create New 
Tablespaces 
(Optional) 


This section discusses the procedures for preparing your Version 6.0 
Database for importing Version 5.1 data. You should follow these 
procedures only after you have finished Preparing your Version 5.1 
database. Note that the SQL statements described in this section are 
issued from the SQL*DBA utility. If you wish to use the SQL*DBA utility, 
refer to Chapter 5 of this Guide for more information. 


To ensure that you perform the following procedures on your Version 6.0 
database, set the CONFIG, PATH, and LIBPATH (OS/2 only) 
environment variables to point to your Version 6.0 subdirectories, 
Substitute the directory names shown in the examples with the directory 
names for your system. Note that you can also set these variables by 
using the values contained in your CONFIG.SYS file. To use the 
CONFIG.SYS file values, simply reboot your system. 


C> SET CONFIG=C : \ORACLE6 \CONFIG.ORA 
C> SET PATH=C : \ORACLE6\BIN 


[C:\] SET CONFIG=C : \ORACLE6\CONFIG,ORA 
[C:\] SET PATH=C: \ORACLE6\BIN 


For OS/2, also set the following parameter in your CONFIG.SYS file and 
reboot: 


LIBPATH=C: \ORACLE6 \DLL 


If your Version 5.1 database stores information in separate partitions, and 
you wish to have these partitions correspond with Version 6.0 tablespaces, 
you must create the new tablespaces in your database. (Refer to “Create 
New Partitions” in Section I for a discussion of partitions and 

tablespaces.) To create a new tablespace, issue the CREATE 
TABLESPACE statement. For example, type 


SOLDBA> CREATE TABLESPACE tablespace DATAFILE filespec; 


where tablespace is the name of the new tablespace, and filespec defines the 
name, size, and location of the database file. 


| 
4-18 ORACLE Database Installation and User's Guide 














Add Rollback 
Segments 


The syntax of filespec for an DOS or OS/2 database is 


‘pathname\filename’ [SIZE integer [KIM]] [REUSE] 
where: 


‘pathname\filename’ is the full path (including drive) and filename of the 
database file to create. Note that you must enclose the 
path and filename in single quotes. If you specify 
only the pathname and filename (and leave out the 
following size definition) ORACLE creates a 2 Mb 
data file. 


integer is the size (in either kilobytes or megabytes) of the 
database file to create. If you do not specify a size, 
ORACLE uses the default size for redo-log files and 
database files (refer to the following sections for a 
discussion of these defaults). 


Note: You should make each tablespace’s database 
file as large as each corresponding Version 5.1 
partition (the sizes you recorded in Section I of this 
chapter). 


KorM is the unit of measure for the integer specified. A “K” 
after the integer designates kilobytes. An “M” after 
the integer specifies megabytes. Kilobytes are used if 
you specify no units. 


REUSE specifies that existing files should be reused, thus 
destroying any information they contain. 


Note: You can specify a number of additional options when you use the 
ALTER TABLESPACE statement. Be sure to refer to the SQL Language 
Reference Manual before altering a tablespace on your system. 


Since you will insert large amounts of data into your Version 6.0 database, 
you should increase the number of private rollback segments available for 
data recovery. The number and size of the new rollback segments depend 
upon the amount of data you are importing. In general, the more rollback 
segments you create, the better the performance; you can always drop the 
extra rollback segments after importing your Version 5.1 data. 


Note: If you already created one or more new tablespaces in your 
database, you must create at least one new rollback segment in your 
SYSTEM tablespace. 
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Create New Tables 
(Optional) 


Import the 
Version 5.1 Data 


To create and activate a private rollback segment, first use the SQL 
statement: 


SQLDBA> CREATE ROLLBACK SEGMENT segment_name 
2> TABLESPACE tablespace_name STORAGE storage; 


(Refer to the SQL Language Reference Manual for more information about 
the CREATE ROLLBACK SEGMENT statement.) Next, add the name of 
the new rollback segment to the ROLLBACK SEGMENTS parameter in 
the INIT.ORA file. For example, if you added a new rollback segment 
called USERS2_RS, the INIT parameter might resemble the following: 


ROLLBACK_SEGMENTS - (SYSTEM_RS, USERS2_RS) 


After naming all rollback segments in the INIT.ORA file, shut down and 
restart the Version 6.0 database. For a complete discussion of creating and 
altering rollback segments, refer to Chapter 16 of the ORACLE RDBMS 
Database Administrator's Guide. 


You may want to create some new database tables in advance to make 
Optimal use of storage parameters and column constraints, rather than 
using the default storage parameters determined by the export. When 
you create tables in advance you can predetermine which tablespaces are 
occupied by data and which by indexes, 


If you create tables in advance, you must create any indexes for these 
tables after you import the Version 5.1 data. The IMP utility will not 
import indexes for tables that already exist. 


Note: If you have the IMP utility create the tables, their accompanying 
indexes are automatically created for you. However, it is generally faster 
to import a table’s data and create the tables’ indexes afterwards. 


Import the Version 5.1 data using the Version 6.0 IMP utility. The Version 
6.0 IMP utility is designed to handle conversions to Version 6.0 structures 
automatically. Refer to the Version 6.0 ORACLE RDBMS Utilities User's 
Guide for a complete description of IMP. To import the data, type 


C> IMP dba_username/dba_password FILE=filename FULL=Y 


Where filename corresponds to the file you exported at the end of Section 1. 
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Create New Table and If you created new tables before importing the Version 5.1 data, you may 
Cluster Indexes want to re-create indexes for those tables. When you import data into 
existing Version 6.0 tables, the indexes are not created automatically. 


If you imported any Version 5.1 clusters, you must create corresponding 
cluster indexes in your Version 6.0 database. The IMP utility does not 
create cluster indexes automatically. Refer to Chapter 5 of the ORACLE 
RDBMS Database Administrator's Guide for a detailed discussion of creating 
and using clusters. 
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Section III: Prepare User Accounts and Applications 


Upgrade User 
Accounts 


Upgrade ORACLE Data 
Loader (ODL) Scripts 


Upgrade 
Applications 


Required Changes to All 
Applications 


This section explains how to finish upgrading to ORACLE Version 6.0. 
The instructions below should be performed after you have successfully 
imported your Version 5.1 data into the new Version 6.0 database. 


accounts: 


SOLDBA> GRANT CONNECT, RESOURCE TO user_name 
2> IDENTIFIED BY new_password; 


If you wish, you can also alter accounts having resource Privileges to 
assign default and temporary tablespaces. Refer to the ORACLE RDBMS 
Database Administrator's Guide for more information about the ALTER 
USER statement. 


C> ODL2LDR ODL_filename loader_fi lename 


where ODL_filename is your existing control filename and loader _filename 
is the name of the new control file, 


When you upgrade from ORACLE Version 5.1 to Version 6.0, you should 
modify Version 5.1 applications to enhance their performance. Some of 
the following modifications are required for all Version 5.1 applications. 
Other modifications are optional. 


The following is a list of required changes to all ORACLE database 
applications. Refer to the ORACLE RDBMS Database Administrator's Guide 
for descriptions of these new ORACLE Database features. 


1. Modify applications to reflect the new method of sorting of nulls. Under 
Version 6.0, nulls are considered larger than the largest value of the 
column that is being sorted. 


2. Modify applications to accommodate errors generated for numeric 
overflow or underflow. 
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. Modify applications to adjust for statement-level rollback on execution 


errors. In Version 5.1, execution errors caused the rollback of the 
entire transaction. 


. Modify applications to adjust for the new definition of ROWID. Refer to 


the definition of ROWID in both the SQL Language Reference Manual 
and the ORACLE RDBMS Database Administrator's Guide. 


. Remove or replace references to the following Version 5.1 data structures 


that no longer exist: 


e ALTER PARTITION 

e CREATE PARTITION 

e ALTERSPACE 

e CREATE SPACE 

e DROP SPACE 

e “ON tablename” clause of VALIDATE INDEX 
e “ON tablename” clause of DROP INDEX 

e “NOCOMPRESS” option of CREATE INDEX 
e SPACE DEFINITION 


. Adjust applications that use queries in the SET clause of the 


UPDATE statement. Queries that returned no rows will now return 
NULL. For example, 


UPDATE BONUS A 
SET COMM = (SELECT COMM FROM EMP 
WHERE A.ENAME = ENAME); 


would set COMM to NULL if the query returns no rows. 


. Remove all references to the Version 5.1 data dictionary and replace 


them with references to the Version 6.0 data dictionary. Even though 
the Version 5.1 data dictionary has been included with the Version 6.0 
database, you should use the Version 6.0 data dictionary. Future 
releases of the ORACLE Database will not include support for the 
Version 5.1 data dictionary. 


. Replace all references to SYSTEM.DATA_DICTIONARY_TABLE with 


SYS.DATA_DICTIONARY_TABLE. SYS now owns all 
data-dictionary tables and views. For example, applications that refer 
to SYSTEM.DUAL should now reference SYS.DUAL. Oracle 
Corporation also recommends that you use synonyms for 
data-dictionary objects rather than direct references to tables or views 
owned by SYS. For example, refer to DUAL rather than SYS.DUAL. 
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Refer to Appendix F, “National Language Support,” in the ORACLE 
RDBMS Database Administrator's Guide for more information. 


10. Check for references to COMMIT and ROLLBACK as SQL*Plus 
statements; they are now SQL statements and must be followed bya 


semicolon. 
Optional Changes to The following is a list of optional changes to all ORACLE database 
All Applications applications. 


1. Take advantage of the performance improvements that the following 
features can add to your application: 


e the storage parameters of the CREATE TABLE and ALTER 
TABLE statements 

* the NOSORT parameter of the CREATE INDEX statement 

* sequence-number generators 

* savepoints 

* the SET TRANSACTION READ ONLY statement 


Refer to the ORACLE RDBMS Database Administrator's Guide for more 
information about all of these subjects. Also refer to the SQL Language 
Reference Manual for more detailed information about the SQL 
statements. 


2. Modify applications to adjust for the new transaction model that 
performs row-level locking. All applications running under ORACLE 
with the transaction processing option automatically use row-level 


locking. Only those applications that use explicit locking need to be 
changed. 


All code used to work around this potential problem can be removed 
for ORACLE Version 6.0 with the transaction Processing option. 
Refer to the discussions on locking in both the SQL Language Reference 
Manual and the ORACLE RDBMS Database Administrator's Guide. 


3. Run the DBA_SYNO.SQL script for each DBA account. This script 
creates the necessary private synonyms for the data-dictionary views 
with the DBA_ prefix. For additional security, public synonyms are 
no longer created for DBA data-dictionary views, 
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Upgrading Export and If you use text files to answer your EXP and IMP prompts, revise these 

Import Applications files to reflect the new syntax of the EXP and IMP utilities. You should 
also consider taking advantage of incremental and cumulative exports 
with the EXP utility. Refer to the ORACLE RDBMS Utilities User's Guide 
for more information. 


Upgrading Applications The following list describes changes to be made to precompiled or 
Developed with the ORACLE Call Interface (OCI) programs when upgrading to work with 








Programmatic Interfaces ORACLE Version 6.0. 
1. 


If precompiling with MODE=ANSI13, recode applications to 
accommodate the ANSI standard +100 error. The +100 error is now 
returned in SQLCODE when an “INSERT INTO tablename SELECT” 
statement selects no rows. The value +1403 is returned in Version 5.1 
compatibility mode. The default MODE=ORACLE does not require 
this change. 


. ROWID now returns SQLTYPE 69. Recode all applications that expect 


the old Version 5.1 SOLTYPE 11. 


. Recode applications that perform updates across COMMITs. Version 5.1 


row locks were placed as each row was FETCHed and thus updates 
across COMMITs were possible. Version 6.0 rows are locked during 
the OPEN cursor phase, and consequently a COMMIT will release all 
locks. 


. Version 1.3 of the ORACLE Programmatic Interfaces includes two new 


command-line options, SOLCHECK and MODE. SOLCHECK 
performs syntax and semantic checking; setting SOLCHECK to 
NONE is equivalent to using Version 5.1 checking. Setting MODE to 
ORACLE is equivalent to Version 5.1 behavior. Refer to the 
Programmer's Guide to the ORACLE Precompilers for more information. 


. Version 1.3 of the ORACLE Programmatic Interfaces includes two new 


ORACLE Call Interface (OCI) functions, OSBNDP and OTEX. 
Together, these functions provide significant performance 
enhancement in a networked environment. Refer to the Pro*C for 
DOS and OS/2 Getting Started manual for more information. 


Note: Pro*C is available separately; contact Oracle Customer Support 
or your Oracle Sales Representative for details. 
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CHAPTER 


INITIAL DATABASE 
ADMINISTRATION 


his chapter discusses the responsibilities of the database 

administrator (DBA). This chapter also provides information 
about the initial tasks a DBA should perform after installing ORACLE 
in the DOS and OS/2 environments. You should use this chapter as a 
supplement to the ORACLE RDBMS Database Administrator's Guide. It 
is important that you read that Guide in addition to this chapter, in 
order to perform the duties of the DBA properly. 


Note: Refer also to Appendix A of this Guide, “Unique DOS 
Limitations,” for any limitations that may exist when using ORACLE 
under DOS. 
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AA 
What Is a Database Administrator? 


The DBA is responsible for managing and maintaining a database. 
Specifically, the DBA is responsible for the database administration 
activities described in this chapter and in the ORACLE RDBMS 
Database Administrator's Guide. These activities include: 

* starting and stopping ORACLE 

* setting up and maintaining user accounts 

* creating and expanding the database 

e backing up and recovering the database 

* tuning database performance 

° controlling ORACLE operating parameters 

* loading data into the database 


The first two of these activities are discussed in this chapter. The 
remaining activities are described in Chapters 6 through 11. 


eT 
Using the SQL*DBA Utility 





The statements described in this chapter and the chapters that follow 
are issued from SQL*DBA, a new tool for database administrators. You 
can use SQL*DBA to execute SQL statements and special SOL*DBA 
statements used to manage the database. SQL*DBA uses a 
command-line interface similar to that used by DOS or 05/2. 
SQL*DBA also uses special MONITOR screens that display information 
about database performance and usage. 


To start the SQL*DBA utility, type the following command: 


C> SOLDBA 


To exit SQL*DBA, use the EXIT statement: 


SQLDBA> EXIT 
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The HOST Statement 


SQL*DBA provides a special HOST statement used to interrupt the 
current SQL*DBA session and perform operating-system commands. 
The HOST statement can be followed by a single operating-system 
command or it can be used alone. If you include an operating-system 
command after the HOST statement, SQL*DBA performs that 
command and immediately returns to the SQL*DBA prompt. For 
example: 


SOLDBA> HOST DIR 


Volume in drive C has no label 
Directory of C:\ORACLE6 


<DIR> 12-19-90. 2:02p 
ar <DIR> 12-19-90 2:02p 
PBIN <DIR> 12-19-90 2:02p 
BIN <DIR> 12-19-90 2:02p 
DBS <DIR> 12-19-90 2:02p 
CONFIG ORA 58 12-19-90 2:06p 
LOADER <DIR> 12-19-90 2078 


7 File(s) 28086272 bytes free 


SQLDBA> 


If you do not specify an operating-system command after the HOST 
statement, SQL*DBA temporarily returns to your operating-system 
environment (for example, the DOS prompt). This is most useful if you 
wish to execute a number of different operating-system commands. 
After you have finished entering operating-system commands, use the 
EXIT command to return to the current SOL*DBA session. For example: 


SQLDBA> HOST 

C> CD ORACLE6\DBS 

C\ORACLE6\DBS> RENAME ANSI.CRT DEFAULT.CRT 
C\ORACLE6 \DBS> EXIT 

SOLDBA> 


Note: ORACLE Database for DOS is a single-process database. You 
should not use the HOST statement to start another program that will 
connect to ORACLE (such as an ORACLE Tool). If you attempt a 
second logon while you have uncommitted database transactions, you 
will receive an ORACLE Database error message. 
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L 


System-Privileged 
Commands and DBA 
Authorization 


Setting the SQL*DBA 
Authorization Password 


Certain SQL*DBA commands are considered system-privileged. 
System-privileged commands have powerful effects on the ORACLE 
database. For example, STARTUP, SHUTDOWN, and CONNECT 
INTERNAL are all system-privileged. 


Under many systems, ORACLE limits users’ access to 
system-privileged commands by checking individual operating-system 
accounts. If an operating-system account possesses special DBA 
privileges, then ORACLE grants that user access to system-privileged 
commands. 


The DOS and OS/2 operating systems, however, do not make use of 
user accounts. Instead you must use a SQL*DBA authorization 
password to control users’ access to system-privileged statements. You 
can set the SQL*DBA authorization password in one of two ways: 


1. You can set the initial password during the ORACLE installation 
process. The installation program prompts you for an 
authorization password when you install the RDBMS software or 
the RDBMS software and the initial database. 


2. You can change the current SQL*DBA password by running the 
DBAPWD utility, which is located in the \ORACLE6\ BIN 
subdirectory. To run DBAPWD, type: 


C> DBAPWD 


The program prompts you for the current authorization password. 
Enter the password and DBAPWD displays the prompt: 


<C>hange or <D>elete password (C or D): 


You should only delete your password if you intend to remove the 
ORACLE software from your computer, 


If you elect to change the password, DBAPWD prompts you for the 
old and new passwords, and then for a verification, Re-type the 
new password for verification. Your password must be at least six 
(6) characters in length. If you answer the prompts correctly, you 
receive the message: 


Success. 


Note: If you forget or delete the DBA authorization password, you must 
reinstall the ORACLE Database software to set a new password. 
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Using the When you install the ORACLE Database for DOS software, the 

DBA_AUTHORIZATION _ installation program places your DBA authorization password into the 

Parameter CONFIG.ORA file as the value of the DBA_AUTHORIZATION 
parameter. This enables you to perform all of the SQL*DBA 
system-privileged commands without having to type your DBA 
authorization password. ORACLE automatically reads your password 
from CONFIG.ORA whenever the DBA authorization is required. 


Note, however, that this overrides the default level of ORACLE 
security, as any user having access to your computer can perform 
system-privileged commands. 


If you are using ORACLE Database for OS/2 and you wish to have 
ORACLE read your authorization password automatically, simply set 
the DBA_AUTHORIZATION parameter in CONFIG.ORA. To set the 
DBA_AUTHORIZATION parameter, add the line 


DBA_AUTHORIZATION=aut horization_password 


to your CONFIG.ORA file. Refer to Chapter 9 for more information 
about working with CONFIG.ORA file and its parameters, 


Using the Authorization If you do not use the DBA_AUTHORIZATION parameter, you must 

Password enter your DBA authorization password before performing any 
SQL*DBA system-privileged commands. To enter the authorization 
password, start SQL*DBA and type the statement: 


SQLDBA> SET AUTHORIZATION 


(This statement can also be abbreviated as SET AUTH.) SQL*DBA 
prompts you to enter the authorization password. If you enter the 
password correctly, SQL*DBA responds with “DBA Authorization 
GRANTED.” 


Note that you can also include the authorization password after 
system-privileged statements issued from the DOS or OS/2 command 
lines. For example, to shut down a database from either operating 
system, type: 


C> SOLDBA SHUTDOWN AUTHORIZATION=authorizat i on_password 
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The MONITOR 
Statement 


Using MONITOR Screens 
with a Remote Database 


You can use SQL*DBA to observe the performance and use of 
databases by displaying a SOL*DBA MONITOR screen. SQL*DBA 
MONITOR screens are primarily used with multi-user ORACLE 
databases. However, you can use them to examine the state of your 
local database or to monitor the operation of remote databases as well. 
Refer to Appendix B of the ORACLE RDBMS Database Administrator's 
Guide for more information about SQL*DBA MONITOR screens. 


If you experience any problems with your SQL*DBA MONITOR 
screens, refer to the section below, “Correcting SOL*DBA MONITOR 
Screens.” 


If you wish to use the MONITOR statement with a remote database, 
follow the instructions below. 


1. If you are using ORACLE Database for DOS, start SOLPME and 
your SQL*Net driver. For example, if you are using the SQL*Net 
SPX/IPX driver, type: 


C> SQLPME 
C> SOLSPX 


. Start SOL*DBA: 


C> SOLDBA 


N 


3. Specify the remote database server to which SQL*DBA should 
connect. Enter the statement 


SOLDBA> SET INSTANCE X: server_name 
where X: is the network prefix for your SQL*Net driver and 


server_name is the server name specified when you started SQL*Net 
on the database server. 


> 


- Connect to the database with DBA privileges: 
SOLDBA> CONNECT dba_username/dba_password 
5. Display the desired SOL*DBA MONITOR screen by following the 


directions in Appendix B of the ORACLE RDBMS Database 
Administrator's Guide. 
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Correcting SQL*DBA 
MONITOR Screens 


Granting Access to 
MONITOR Information 


Before drawing MONITOR screens, SQL*DBA determines your 
system’s terminal type by examining the DEFAULT.CRT file (located in 
the \ORACLE6\DBS subdirectory). The DEFAULT.CRT file specifies 
the terminal definition for your computer. In most cases the default 
terminal definition, VIDEO, is appropriate for your computer system. 
If, however, you experience problems with the appearance of 
SQL*DBA MONITOR screens, follow the steps below to change your 
terminal definition. 


1. If you are operating under DOS, place the following line in your 
CONFIG.SYS file. (You may need to substitute the correct path to 
ANSLSYS for your system configuration.) 


DEVICE=C: \DOS\ANSI.SYS 
If you are operating under OS/2, type: 


[C:\] ANSI ON 


N 


. Modify your CONFIG.ORA file to include the following line: 


ORACLE_TIO=ANSI 


w 


. Copy the ANSI.CRT file to the new name, DEFAULT.CRT, in your 
\DBS subdirectory. ANSI.CRT is located in the \DBS subdirectory 
of your ORACLE home directory. 


These procedures correct SOL*DBA MONITOR screens under most 
circumstances. 


SQL*DBA creates its MONITOR screens from the dynamic 
performance tables located in the data dictionary. When you first 
install ORACLE, the dynamic performance tables are available only to 
the user name SYS. However, you can make this information available 
to other users if you wish. 


To make the dynamic performance tables available to all users, execute 
the MONITOR.SQL script, installed in the \ORACLE6\ DBS 
subdirectory. MONITOR.SQL grants public access to certain views of 
the dynamic performance tables. If you wish to grant access only to a 
subset of users, use a text editor to modify the GRANT SELECT 
statements in the MONITOR.SQL script. 


To run the MONITOR.SQL script, type: 


SOLDBA> CONNECT S 
SOLDBA> (MONITOR. SQL 





sys_password 
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A a] 
Starting and Stopping ORACLE Database for DOS 


The ORACLE.BAT File 


ORACLE STARTUP 
Activities 


To start ORACLE Database for DOS, perform the following procedures: 
1. Start SOLPME, the SOL Protected-Mode Executive. 
2. Start the ORACLE Database executable program, ORACLE6.EXE. 
3. Issue a SOL*DBA STARTUP statement. 


For example, if you wanted to start ORACLE using the standard 
SQL*DBA STARTUP statement, you would type: 


C> SOLPME 
C> ORACLE6 
C> SQLDBA STARTUP 


Note: These commands assume that you have included the 
DBA_AUTHORIZATION parameter in your CONFIG.ORA file. Refer 
to “Using the Authorization Password” earlier in this chapter for more 
information. 


You can also execute the above commands at once by using the 
ORACLE.BAT file provided with the ORACLE Database for DOS. The 
syntax of the ORACLE command is as follows: 


C> ORACLE [authorization] 


If you have not set the DBA_AUTHORIZATION Parameter in your 
CONFIG.ORA file, you should supply the authorization option where 
authorization is your DBA authorization password. If the 
DBA_AUTHORIZATION parameter is set, simply type ORACLE. 


If you wish to start ORACLE every time you start your computer, add 
the ORACLE command to your DOS AUTOEXEC BAT file. 


When ORACLE is started up it consults two files, INIT.ORA and 
CONFIG.ORA, to set database characteristics and to control the DOS 
system resources, respectively. These files can be modified to suit your 
needs; refer to Chapters 6 and 7 in this Guide for more information, 


During the start up, SQL*DBA displays information about the System 
Global Area (SGA), an area of memory in which ORACLE stores and 
manipulates data. Refer to Chapter 8 of the ORACLE RDBMS Database 
Administrator's Guide for more information about the SGA. 
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Starting ORACLE with ORACLE cannot operate in memory that is configured as expanded 

Expanded Memory memory. However, ORACLE can operate in conjunction with 

Managers expanded memory-management products that comply with the Virtual 
Control Program Interface (VCPI) standards for memory managers. 


To use ORACLE or protected-mode ORACLE products with a 
third-party memory manager, follow the steps below 


l 


Be sure you have selected your memory-management program 
name or “VCPI” as your machine type during the ORACLE 
installation. (Refer to Chapter 3 for information about selecting 
your machine type.) 


. When you use your memory-management software, configure all 


available memory as expanded memory. (Most memory managers 
do this automatically when they are loaded.) Refer to the 
documentation for your memory-management program for more 
information. 


. Set the amount of memory available for ORACLE products. Do this 


by setting the DYNAMIC_MEMORY parameter in the 
CONFIG.ORA file. Using a text editor, add the parameter 


DYNAMIC_MEMORY=integer 


where integer specifies the number of kilobytes (K) of extended 
memory that ORACLE products may use. Any memory in excess 
of this number will remain configured as expanded memory. 


Note: If you do not specify a value for DYNAMIC_MEMORY, or if 
you specify a value greater than the amount of memory available, 
ORACLE will use all the available memory above 640K for its own 
use. 


Refer to Chapter 6 for more information about the CONFIG file and 
the DYNAMIC_MEMORY parameter. 


4. Start ORACLE using the instructions outlined in the previous 
section. 
Stopping ORACLE To stop ORACLE Database for DOS, first terminate your connection to 
Database for DOS the database using the SQL*DBA DISCONNECT statement: 


SQLDBA> DISCONNECT 
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Removing ORACLE 
Software from RAM 


After you have disconnected, shut down the database using the 
SQL*DBA SHUTDOWN statement. Note that SHUTDOWN is a 
system-privileged SQL*DBA statement; if you have not set the DBA 
authorization password, you must do so before entering SHUTDOWN. 
(Refer to “Using the Authorization Password” earlier in this chapter for 
more information.) Enter the SHUTDOWN statement as follows: 


SOLDBA> SHUTDOWN 


SHUTDOWN closes and dismounts the database and stops the 
ORACLE instance. For further information about the SHUTDOWN 
statement, refer to Appendix B in the ORACLE RDBMS Database 
Administrator's Guide. 


Once you start ORACLE, it remains in your computer's extended 
memory, even after the SHUTDOWN statement is issued. 


The REMORA command removes from memory one or all currently 
loaded drivers that you specify (for example, SQL*Net or the database 
software). REMORA has three options: LIST, ALL, and prefixid. Use 
the command format 


C> REMORA [LIST|ALL| prefixid] 


where: 
LIST displays the Prefix IDs of all current! loaded 
Play y 

drivers, including the database software. The 
Prefix ID “S”: is displayed for ORACLE Database 
for DOS. 

ALL removes all currently loaded SOL*Net drivers, 
including the database software. 

prefixid removes only the driver that corresponds to the 


prefix ID you enter. For example, the following 
command would remove the ORACLE SQL*Net 
TCP/IP driver from memory: 


C> REMORA T: 
If REMORA is entered without specifying an option, the available 
options are displayed. 


To remove ORACLE Database for DOS from RAM and free the 
extended memory SQLPME has reserved for ORACLE, enter the 
command: 


C> REMORA S: 
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Removing SOLPME 
from RAM 


In this statement, “S:” is the prefix ID for the ORACLE Database for 
DOS single-task driver. 


Note: You need not remove ORACLE from RAM before restarting or 
shutting down your computer. It is safe to restart or shut down the 
computer any time you commit your most recent changes to the 
database. 


To remove SQLPME and free all memory used by SOLPME, enter the 
command: 


C> REMPME 


Note: REMPME automatically performs a REMORA ALL command 
before removing SQLPME from memory. Refer to the previous section 
for a discussion of the REMORA ALL command. 
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EE) 
Starting and Stopping ORACLE Database for OS/2 


To start ORACLE, first start SQL*DBA and enter the authorization 
08/2 string: 
[C:\] SOLDBA 


SOLDBA> SET AUTHORIZATION 


SQL*DBA prompts you for the authorization password. Enter the 
password and type the STARTUP statement to start the database: 


SOLDBA> STARTUP 


This statement loads the ORACLE kernel into memory and starts up 
the ORACLE database (or, more specifically, starts an ORACLE 
instance and mounts and opens the database). 


ORACLE STARTUP When ORACLE is started up it consults two files, INIT.ORA and 

Activities CONFIG.ORA, to set database characteristics and to control the OS/2 
system resources, respectively. These files can be modified to suit your 
needs; refer to Chapters 6 and 7 in this Guide for more information. 


During the startup, SQL*DBA displays information about the System 
Global Area (SGA), an area of memory in which ORACLE stores and 
manipulates data. Refer to Chapter 8 of the ORACLE RDBMS Database 
Administrator's Guide for more information about the SGA. 


Stopping ORACLE To stop ORACLE Database for OS/2, first terminate all connections to 
Database for OS/2 the database using the SQL*DBA DISCONNECT statement: 


SOLDBA> DISCONNECT 


After you have disconnected, shut down the database using the 
SQL*DBA SHUTDOWN statement. Note that SHUTDOWN is a 
system-privileged SQL*DBA statement; if you have not set the DBA 
authorization password, you must do so before entering SHUTDOWN. 
(Refer to “Using the Authorization Password” earlier in this chapter for 
more information.) Enter the SHUTDOWN statement as follows: 
SOLDBA> SHUTDOWN 

SHUTDOWN closes and dismounts the database, and stops the 
ORACLE instance. SHUTDOWN also removes the ORACLE Database 
software from RAM. For further information about the SHUTDOWN 
statement, refer to Appendix B in the ORACLE RDBMS Database 
Administrator's Guide. 
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AR] 
Setting Up User Accounts 


Changing the 
Passwords for SYS and 
SYSTEM 


ORACLE controls access to the database through ORACLE usernames 
and passwords. You can also assign various privileges to users, such as 
CONNECT, RESOURCE, and DBA privileges, which control users’ 
access to the database and the data within the database. User accounts 
with DBA privileges are used to perform database-administration 
tasks. For more information about user accounts and privileges, refer 
to Chapter 17 of the ORACLE RDBMS Database Administrator's Guide. 


The initial database is installed with two user accounts having DBA 
privileges: SYS and SYSTEM. SYSTEM has the predefined password 
MANAGER, and SYS has the predefined password 
CHANGE_ON_INSTALL. Since a user account with DBA privileges 
can modify critical database tables and user passwords, you should 
change the default passwords for SYS and SYSTEM immediately after 
installing ORACLE: 


1. Start up ORACLE and the SQL*DBA utility using the commands 
described earlier in this chapter. 


2. Log on to ORACLE using the username SYSTEM. Enter the following 
commands: 


SQLDBA> CONNECT SYSTEM/MANAGER 
3. User the GRANT statement to enter a new password for SYSTEM: 
SQLDBA> GRANT CONNECT TO SYSTEM IDENTIFIED BY new_password; 
4. Enter a new SYS password and exit SQL*DBA: 


SQLDBA> GRANT CONNECT TO SYS IDENTIFIED BY new_password; 
SQLDBA> EXIT 


Note: SYSTEM should be used only for the purpose of database 
administration and SYS should be used rarely, if ever. Refer to Chapter 
2 of the ORACLE RDBMS Database Administrator’s Guide for more 
information about SYS and SYSTEM. 
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Defining OPS$ User In addition to defining individual ORACLE user accounts and 

Accounts passwords, you can define an ORACLE operating-system account, or 
OPS$ account. An OPS$ account enables a user to log on to ORACLE 
without specifying an ORACLE username and password. Users 
simply bypass the username and password prompts by pressing 
[Enter]. 


When a user logs on to ORACLE in this manner, the ORACLE software 
grants privileges based on an OPS$ account that you specify in your 
CONFIG.ORA file (refer to Chapter 9 for more information the 
CONFIG.ORA file). 


Note: Using an OPS$ account circumvents part of the ORACLE 
Database security, as anyone can gain access to the OPS$ account 
privileges. Keep this in mind when you grant privileges to OPS$ 
accounts. 


Follow the steps below to create an OPS$ user account: 


1. Add a username for the OPS$ account as the value of the 
USERNAME parameter in your CONFIG.ORA file. For example, 
to create an OPS$ account with the username GUEST, add the line: 


USERNAME=GUEST 
Note: The username that you enter must be no more than 26 
characters in length. 
2. Log on to SQL*DBA with DBA privileges: 
C> SQLDBA 


SQLDBA> CONNECT dba_user name/dba_password 


3. Use the GRANT statement to assign privileges to your new OPS$ 
username. Note that you must include the OPS$ prefix to the 
username in the GRANT statement. For example, to grant 
CONNECT privileges to the GUEST username you created in Step 
1, type: 

SOLDBA> GRANT CONNECT TO OPS$guest IDENTIFIED BY password; 


Note that the password you define is irrelevant. ORACLE will 
grant the OPS$ account privileges to anyone who bypasses the 
username and password prompts. 


Refer to Chapter 17 of the ORACLE RDBMS Database Administrator's 
Guide for more information about OPS$ accounts. 


5-14 ORACLE Database Installation and User's Guide 








CHAPTER 


INITIAL DATABASE 
CREATION 


TE chapter describes the procedures for creating a database with 
ORACLE for DOS and ORACLE for OS/2. This chapter also 
describes the structure of the initial database that you can install with 
the ORACLE installation program. You should use this chapter in 
conjunction with Chapter 13 of the ORACLE RDBMS Database 
Administrator's Guide. 
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A ere 
The Initial ORACLE Database 


Tablespaces and Users 
Accounts 


TABLE 6-1 
Initial Database User Accounts 


Database Files and 
Rollback Segments 


TABLE 6-2 
Initial Database Files 


When you install ORACLE Database for DOS or OS/2, you have the 
option of installing an initial database along with the ORACLE 
Database software. This initial database is intended to help you begin 
using ORACLE with your system. If you did not install the initial 
database during installation and you wish to do so, simply follow the 
directions in Chapter 3 under “Installing the Database.” When 
prompted, choose the option to install the initial database only. 


The initial ORACLE database contains two tablespaces: SYSTEM and 
USERS. The SYSTEM tablespace holds the ORACLE data-dictionary 
tables and views. The USERS tablespace holds sample table data; it is 
intended for new database user accounts, ORACLE also creates three 
default user accounts, each of which is described in Table 6-1. 





User Name Password Privileges 

SYS CHANGE_ON_ INSTALL DBA 

SYSTEM MANAGER DBA 

SCOTT TIGER CONNECT, RESOURCE 


(with USERS tablespace only) 


The initial database is created with the control, redo log, and data files 
described in Table 6-2. The database also contains two rollback 
segments, SYSTEM_RS and USERS_RS. Each rollback segments resides 
in the SYSTEM tablespace. 





Type of File Name Size 

Control CONTROL1.ORA varies 
Database DBS1.ORA 2 Megabytes 
Database DBS2.ORA 2 Megabytes 
Database USERS1.ORA 300 Kilobytes 
Redo Log LOG1.ORA 200 Kilobytes 
Redo Log LOG2.ORA 200 Kilobytes 
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AAA 
Creating a New Database 


Steps for Creating a 
Database 


If the initial database installed during the ORACLE installation 
procedure does not meet your specifications, you may wish to create a 
new ORACLE database from scratch or modify the initial database to 
suit your needs. This section outlines the steps necessary for manually 
creating a new ORACLE database. Refer to the ORACLE RDBMS 
Database Administrator's Guide for information about modifying an 
existing database. 


Creating a new ORACLE database involves creating and initializing 
several operating-system files that ORACLE uses. When you create a 
new database using ORACLE Database for DOS or ORACLE Database 
for OS/2, you need only enter the SOL*DBA CREATE DATABASE 
statement. The database software automatically creates and initializes 
the required files. 


The following steps outline the procedures required to create a 
database under DOS or OS/2. Some steps refer to the INIT.ORA file 
and INIT parameters. Refer to Chapter 10 of this manual for more 
information about the INIT file. 


1, Check the INIT.ORA file to verify INIT parameter values. 
The ORACLE installation process copies a sample INIT.ORA file 
into the \ORACLE6\DBS subdirectory. This sample INIT.ORA file 
is modified to improve the performance of your database in most 
situations. However, you may wish to create a customized 
INIT.ORA file to modify database performance. Refer to Appendix 
D of the ORACLE RDBMS Database Administrator's Guide and 
Chapter 10 of this manual for information about modifying INIT 
parameters. 


Regardless of whether you use the sample INIT.ORA file or a 
customized INIT file, certain INIT parameters should be set to an 
acceptable value at the time of database creation. Some of the 
following parameters, for example, cannot be modified after the 
database has been created. 


DB_NAME DB_NAME specifies the name of your 
database. The database name is a string of 
eight (8) characters or less. You can use the 
DB_NAME value at startup time to specify 
the database you wish to use. 
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CONTROL FILES CONTROL _ FILES designates the names and 
locations of all control files. By default, 
ORACLE Database for DOS and OS/2 
creates a single control file, CONTROL1.ORA 
in the \ORACLE6\DBS subdirectory. Note 
that Oracle Corporation recommends the use 
of at least two control files, each located on a 
separate storage device. 


INIT_SQL_FILES INIT_SQL_FILES specifies the names and 
locations of SQL script files that run during 
database creation. Note that you must list the 
default file, SOL.BSO, before any of your 
own files. SQL.BSQ creates the 
data-dictionary tables and views for your 
database. You must also run 
CATALOG.SQL to create the views required 
by ORACLE tools and by the DBA. 


You can run some .SQL files during or after 
database creation. Refer to Step 6 for more 
information about running .SQL files after 
database creation. 


TRANSACTIONS TRANSACTIONS must be set to at least 20 
=> for ORACLE Database for DOS. Setting a 
DOS TRANSACTIONS value of 20 increases the 
size of the System Global Area (SGA) and the 
number of rollback segments to facilitate 


database creation. 
ENQUEUE_ You should set ENQUEUE_ RESOURCES to 
RESOURCES at least 85 for ORACLE Database for DOS. 


This enables the ORACLE software to handle 
the many tables that are accessed during 
DOS database creation. 


2. Load SOLPME and the ORACLE Database executable 
(DOS only). 
Start SQLPME and ORACLE6.EXE, but do not start up the 
database. Enter the commands: 
C> SQLPME 
C> ORACLE6 
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3. Enter SOL*DBA and start an ORACLE instance. 
To create a new database you must start-up an ORACLE instance 
without mounting an existing database. Start the instance by 
starting SOL*DBA and entering the STARTUP NOMOUNT 
statement: 


C> SQLDBA AUTHORIZATION=authorization_password 
SOLDBA> STARTUP NOMOUNT 


If you are using an INIT file other than INIT.ORA, you must designate 
this file at start-up time using the command: 


SQLDBA> STARTUP NOMOUNT PFILE=init_filename 


4. Connect using the keyword INTERNAL. 
Because you have not mounted nor opened a database, you must 
use the CONNECT INTERNAL statement. To connect to the 
instance, type: 


SQLDBA> CONNECT INTERNAL 


5. Create the new database. 
Enter the CREATE DATABASE statement using this syntax: 


CREATE DATABASE database_name 
[CONTROLFILE REUSE] 
[LOGFILE filespec [,filespec] ...] 
[MAXLOGFILES integer] 
[DATAFILE filespec [,filespec] ...] 
[MAXDATAFILES integer] 
| | [MAXINSTANCES integer] 
[ARCHIVELOG | NOARCHIVELOG] 
[EXCLUSIVE] 





The following keywords and parameters have features that are 
specific to DOS and OS/2: 


LOGFILE filespec specifies one or more redo-log files. If you do 
not include this parameter, ORACLE creates 
two log files, LOG1.ORA and LOG2.ORA, in 
the \ORACLE6\DBS subdirectory. The 
default size of each log file is 200 kilobytes. 


DATAFILE specifies one or more database files. If you 

filespec do not include this parameter, ORACLE 
creates one database file, DBS1.ORA, in the 
\ORACLE6\ DBS subdirectory. The default 
size of this database file is 2 megabytes. 
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filespec Filespec defines the name, size, and location 
of a redo-log file or database file. The syntax 
of filespec for an DOS or OS/2 database is of 
the form: 


'pathname\ filename’ [SIZE integer [K|M]] 
[REUSE] 


The options for filespec are described below. 


‘pathname\ filename’ is the path (including drive) and filename of 
the database file to create. Note that you 
should include the full path to the filename. 
Also note that you must enclose the path and 
filename in single quotes. 


integer is the size (in either kilobytes or megabytes) 
of the database file to create. ORACLE uses 
the default size for redo-log files (200K) and 
database files (2Mb) if you do not specify a 
size. 


KorM is the unit of measure for the integer 
specified. A “K” after the integer designates 
kilobytes. An “M” after the integer specifies 
megabytes. Kilobytes are used if you specify 
no units. 


The remaining parameters in the CREATE DATABASE statement 
are described in the SQL Language Reference Manual. 


- Run additional .SQL files (optional). 


Certain SQL statement files, such as SQL.BSQ and 
CATALOG.ORA, should run during database creation (refer to 
Step 1 for more information). You can run other .SQL files, 
including files that you create yourself, after issuing the create 
database statement. 


The following files create certain tables and views that may be 
useful to you. Refer to the ORACLE RDBMS Database 
Administrator's Guide for descriptions of other SQL files. 


CATALOG5.SQL creates ORACLE Database Version 5.1 
data-dictionary views. You may wish to 
create these views to maintain compatibility 
with ORACLE Version 5.1. 
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Creating a New 
Database: An Example 


FIGURE 6-1 
Example INIT File, INIT2.ORA 


FIGURE 6-2 
Example Commands 


EXPVEW.SQL creates views for the Version 6.0 EXP utility. 
Refer to the ORACLE RDBMS Utilities User's 
Guide for more information about EXP. 


EXPVEW5.SQL creates views for the Version 5 EXP utility. 
To run a .SQL file from within SQL*DBA, type: 


SQLDBA> @filename 


Figure 6-2 shows the commands used to create a sample ORACLE 
database. These sample commands create a new ORACLE database 
with two, 200K redo-log files and two, 2Mb database files. The 
example also creates two control files, CONTROL1.ORA and 
CONTROL2.ORA. 


Except for CONTROL2.ORA, all redo-log, database, and control files 
are stored in the \ORACLE6\DBS directory. CONTROL2.ORA is 
saved in the F:\BACKUPS directory (on a separate hard disk). 


This example uses an INIT file, INIT2.ORA, which is stored in the 
\DBS subdirectory. Figure 6-1 shows the contents of this INIT file. 


DB_NAME=ORACLE 

CONTROL_FILES= (C: \ORACLE6 \DBS\CONTROL1.ORA, 
F : \BACKUPS\CONTROL2 . ORA) 

INIT_SQL_FILES=(SQL.BSQ, CATALOG. SQL) 

TRANSACTIONS=20 

ENQUEUE_RESOURCES=85 


C> SQLPME 
C> ORACLE6 
C> SQLDBA 
SOLDBA> SET AUTHORIZATION=authorization_password 
SQLDBA> STARTUP NOMOUNT PFILE=C: \ORACLE6\DBS\INIT2.ORA 
SQLDBA> CONNECT INTERNAL 
SOLDBA> CREATE DATABASE ORACLE 
2> LOGFILE 'C:\ORACLE6\DBS\LOG1.ORA’ SIZE 200 K, 
3> 'C:\ORACLE6\DBS\LOG2.ORA’ SIZE 200 K 
4> DATAFILE 'C:\ORACLE6\DBS\DBS1.ORA’ SIZE 2 M, 
5> 'C:\ORACLE6\DBS\DBS2.ORA’ SIZE 2 M 
6> NOARCHIVELOG; 
SQLDBA> 
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Re 
What Does CREATE DATABASE Do? 


When you enter the CREATE DATABASE statement, ORACLE 
performs the instructions found in the ‘SQL script files designated by 
the INIT_SQL_ FILES INIT parameter. Note that you should first 
include SQL.BSQ followed by CATALOG.SOL in the list of files. 


Default Tablespaces When you create a new database with ORACLE Database for DOS or 

and User Accounts OS/2, the ORACLE software creates a SYSTEM tablespace to hold the 
data-dictionary tables and views. ORACLE also creates two default 
user accounts for the new database, both of which are described in 





Table 6-3. 
TABLE 6-3 User Name Password Privileges 
Default User Accounts p A = u = 
SYS CHANGE_ON_INSTALL DBA 
SYSTEM MANAGER DBA 


Default Database Files ORACLE creates the control files, database files, and redo-log files that 
and Rollback Segments you specify in the CREATE DATABASE statement. If you do not 
designate these files, ORACLE creates the files listed in Table 6-4. 


By default, ORACLE creates only one rollback segment, SYSTEM, 
located in the SYSTEM tablespace. If you wish to add new tablespaces 
to your database, you must create and activate at least one additional 
rollback segment in the SYSTEM tablespace. Refer to Chapter 16 of the 
ORACLE RDBMS Database Administrator's Guide for more information 
about rollback segments. 








TABLE 6-4 Type of File Name Size 

Default Database Files = 
Control CONTROL1.ORA varies 
Database DBS1.ORA 2 Megabytes 
Redo Log LOG1.ORA 200 Kilobytes 
Redo Log LOG2.ORA 200 Kilobytes 





Note: ORACLE places each default file in the \ORACLE6\DBS subdirectory. 
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Managing Database Storage 


Checking Storage Space 


Adding Database Files 


When you create a database or tablespace, you specify the size of initial 
database files, or ORACLE uses a default value. This initial size limits 
the amount of data that can be stored in the tablespace. If a tablespace 
begins to outgrow its initial capacity, you can expand it by adding new 
database files. 


Check the amount of free storage space in a tablespace by selecting 
information from the data-dictionary tables; use the following SQL 
statement to examine the free space in all tablespaces: 


SOLDBA> SELECT TABLESPACE_NAME, SUM(BYTES) FROM SYS.DBA_FREE_SPACE 
2> GROUP BY TABLESPACE_NAME; 


This statement displays the number of bytes of disk space that are 
available in each tablespace. 


You can expand a database by using the ALTER TABLESPACE 
statement to add a new database file. Use the syntax 


SOLDBA> ALTER TABLESPACE tablespace ADD DATAFILE filespec; 


where: 
tablespace is the name of the tablespace to be expanded. 
filespec defines the name, size, and location of a redo-log 


file or database file. The syntax of filespec for an 
DOS or OS/2 database is of the form: 


‘pathname\filename’ [SIZE integer [KIM] ] 
[REUSE] 


The options for filespec are described in the 
previous section, “Creating a New Database.” 
Note, however, that if you specify no filespec 
options in this context, ORACLE assumes that the 
data file already exists and should be used as is. 


Note: You can specify a number of additional options when you use the 
ALTER TABLESPACE statement. Be sure to refer to the SQL Language 
Reference Manual before altering a tablespace on your system. 
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Example: The following example uses SQL*DBA to add a new, one-megabyte 
database file to the USERS tablespace. 


1. Execute SQL*DBA and connect to a database. Note that you must 
have DBA privileges to create a new database file. 
C> SOLDBA 
SOLDBA> CONNECT dba_username/dba_password 

2. Add the database file using the ALTER TABLESPACE statement: 


SOLDBA> ALTER TABLESPACE USERS ADD DATAFILE 
2> 'C:\ORACLE6\DBS\USERS3.ORA’ SIZE 1 M; 


The new database file, USERS3.ORA, is created in the 
\ORACLE6\ DBS directory. 
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CHAPTER 


BACKUP AND 
RECOVERY 


his chapter presents information about backing up and recovering 

ORACLE Database for DOS and ORACLE Database for OS/2. 
This chapter does not provide general information about ORACLE 
backup and recovery procedures; you should refer to Chapter 15 of the 
ORACLE RDBMS Database Administrator's Guide for this information. 
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As a DBA, once you begin to create database structures and add users 
to the system, you should start making regular, perhaps daily, backups. 
ORACLE provides two modes of Operation that determine how you 
should make system backups: ARCHIVELOG mode and 
NOARCHIVELOG mode. ARCHIVELOG mode means that the data in 
online redo-log files is archived before the files are reused. These 
archived log files along with one full database backup can guarantee 
that all committed transactions can be recovered. NOARCHIVELOG 
mode means that no offline redo logs are created, and online redo-log 
files are reused instead of saved. (Refer to Chapter 3 of the ORACLE 
RDBMS Database Administrator's Guide for information about redo-log 
files.) 


Chapter 15 of the ORACLE RDBMS Database Administrator’s Guide 
provides information to help you determine which archive mode to use 
with your ORACLE database. Before referring to that Guide, however, 
note that ORACLE for DOS and ORACLE for OS/2 have different 
levels of support for ARCHIVELOG mode. Under DOS, only 
automatic archiving is supported. You cannot manually archive 
redo-log files. Under OS/2, you can choose between manual and 
automatic archiving. Finally, although ORACLE supports archiving to 
tape, archiving to disk is standard for the DOS and OS/2 operating 
systems. 


The sections that follow describe archiving support for ORACLE 
Database for DOS and ORACLE Database for OS/2 in more detail, 
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Archiving Under DOS 


Enabling Automatic 
Archiving 


Although ORACLE Database for DOS fully supports the automatic 
archiving of redo-log files, it does not support manual archiving. In 
addition, automatic archiving is enabled and disabled in a manner 
different from that discussed in the ORACLE RDBMS Database 
Administrator's Guide. This affects the administration of ORACLE in 
two ways: 


1. You cannot use the SOL*DBA ARCHIVE LOG statement to start or 
stop the archiving process. If you execute this statement ORACLE 
displays the error message, “ORA-00299: ARCHIVE LOG STOP 
not applicable for single process database.” 


2. You cannot use the LOG_ARCHIVE_START INIT.ORA parameter 
to start or stop the archiving process. ORACLE for DOS ignores 
this parameter at database startup. 


Note: You can use the ORACLE Database for DOS SQL*DBA utility to 
control manual archiving when connected to a remote database. Refer 
to the ORACLE RDBMS Database Administrator's Guide for information 
about manual archiving. 


If you wish to enable automatic archiving using ORACLE Database for 
DOS, follow the steps below: 


1. Specify the archive destination. 
The archive destination designates the path and filename under 
which ORACLE will archive redo-log files. You enter the archive 
destination as the value of the INIT file parameter, 
LOG_ARCHIVE_DEST. (Refer to Chapter 10 of this manual for 
more information about modifying INIT file parameters.) 


For example, the following value would store archived log files in 
the D:\ ARCHIVE subdirectory: 


LOG_ARCHIVE_DEST D: \ARCHIVE\ARC.ORA 


In this example, archived log files are stored under the filename 
ARCHHHH .ORA, where ##HHH is a five-digit log sequence 
number assigned by ORACLE Database. If you specify a filename 
of greater than three (3) characters (excluding the three-character 
extension), ORACLE truncates the filename to three characters, 
followed by the log sequence number. 
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Disabling Automatic 
Archiving 


Troubleshooting 
Archive Errors 


Note: The destination you choose can be either a disk file or a tape, 
depending upon the architecture and storage facilities of your 
system. If your system supports tape archiving, you must specify a 
tape drive for your archive destination, or backup log files to tape 
from the DOS command line. For more details on configuring tape 
drives on your system, refer to your DOS documentation. 


2. Place the database in ARCHIVELOG mode. 
After you have specified an archive destination, enable automatic 
archiving by placing the database in ARCHIVELOG mode. Use 
the ALTER DATABASE ARCHIVELOG statement as described in 
the SQL Language Reference Manual. 


ORACLE Database for DOS attempts to archive redo logs until you 
explicitly disable automatic archiving. Thus, even when you shut 
down and restart the database, automatic archiving continues. 


To disable automatic archiving under DOS, place the database in 
NOARCHIVELOG mode. Use the ALTER DATABASE 
NOARCHIVELOG statement as described in the SQL Language 
Reference Manual. 


Note: You cannot stop automatic archiving using the other methods 
described in the ORACLE RDBMS Database Administrator’s Guide. 


To determine whether or not the database is in ARCHIVELOG mode, 
use the statement: 


SQLDBA> ARCHIVE LOG LIST 


Should the archive destination become full or inaccessible during the 
course of automatic archiving, ORACLE returns a series of error 
message to your screen. These messages will differ according to the 
cause of the archiving failure. Refer to Appendix B of this manual for 
descriptions of the errors. 


The error messages are followed by the prompt: 


You now have the following options: 
1. Host out to DOS and rectify the archival problem. 
2. Enter a new path for the log_archive_dest init.ora parameter. 
3. Bring down the database immediately via a protection exception. 
Hit 11%, “2%, or *3 now. 
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Type the number of the option you wish to choose. Your selection will 
generally depend on the type of archiving error you receive. For 
example, if there is a problem with the archive file, you may wish to 
host to DOS and attempt to repair the file. Afterwards, type 


C> EXIT 
to continue the database process. 


If the archive destination is full, type 2 to enter a new archive 
destination (path and filename). Note that this new archive destination 
is temporary; it will only remain valid until you next shutdown the 
database. If you wish to make the new archive destination permanent, 
change the value of the LOG_ARCHIVE_DEST parameter in your 
INIT.ORA file. 


In general, you should never select option 3, as this immediately 
terminates the ORACLE Database program with an error. You may be 
required to select option 3 if a new archive destination fails to correct 
the problem, or if you do not have enough memory to host to DOS. If 
you select option 3, you should reboot your computer before 
attempting to restart the database. 
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Archiving Under OS/2 


Specifying an Archive 
Destination 


ORACLE Database for OS/2 supports both automatic and manual 
archiving as described in Chapter 15 of the ORACLE RDBMS Database 
Administrator's Guide. However, ORACLE Database for OS/2 requires 
some preliminary archiving steps, which are not described in that 
Guide. These steps involve: 


1. specifying an archive destination. 
2. creating the ORACLE_ARCH.CMD file. 


Each of these steps is described in the sections that follow. Note that 
these steps assume that your database is Operating in ARCHIVELOG 
mode. If it is not, use the ALTER DATABASE ARCHIVELOG 
statement to change the mode. Refer to the SQL Language Reference 
Manual for more information. 


After you have performed these preliminary archiving steps, follow the 
instructions in Chapter 15 of the ORACLE RDBMS Database 
Administrator's Guide to enable and disable automatic archiving. 


The archive destination designates the path and filename under which 
ORACLE will archive redo-log files. Enter the archive destination as 
the value of the INIT file parameter, LOG_ARCHIVE_DEST. (Refer to 
Chapter 10 of this manual for more information about modifying INIT 
file parameters.) 


For example, the following value would store archived log files in the 
D:\ARCHIVE subdirectory: 


LOG_ARCHIVE_DEST = D: \ARCHIVE\ARC.ORA 


In this example, archived log files are stored under the filename 
ARC#HHHHLORA, where #HHH is a five-digit log sequence number 
assigned by ORACLE Database. If you specify a filename of greater 
than three (3) characters (excluding the three-character extension), the 
ORACLE Database software truncates the filename to three characters, 
followed by a log sequence number. 


Note: The destination you choose can be either a disk file or a tape, 
depending upon the architecture and storage facilities of your system. 
If your system supports tape archiving, and if you want to archive 
directly to tape, you must either dedicate a tape drive to the ARCH 
process or manually archive your redo-log files to tape on some regular 
basis. For more details on configuring tape drives on your system, 
refer to your OS/2 documentation. 
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Creating the 
ORA_ARCH.CMD File 


Before archiving a redo-log file, ORACLE Database for OS/2 looks for a 
file named ORA_ARCH.CMD. ORACLE uses the ORA_ARCH.CMD 
file to invoke an executable or command that, in turn, copies the redo 
log to its destination. 


ORACLE Database for OS/2 provides a sample ORA_ARCH.CMD file 
for simple archiving purposes. You can also specify a different .CMD 
file executable program (refer to the following section for more 
information). The sample ORA_ARCH.CMD file contains the 
commands: 


COPY %1 %2 
IF EXISTS %2 ERRLVL 0 


The components of the ORA_ARCH.CMD file have the following, 
functions: 


COPY specifies that the OS/2 COPY command is used to 
archive the redo-log file. You can substitute other 
copy commands or copy programs in place of 
COPY. For example, you might wish to use the 
ORACLE OCOPY utility, which is described later 
in this chapter. 


%1 indicates the redo-log file to copy. The value of %1 
is determined by the ORACLE Database software 
at the time of archiving. 


%2 indicates the archive destination. The value of %2 
is determined by the value of the INIT.ORA 
parameter, LOG_ARCHIVE_DEST. Refer to the 
previous section for more details. 


%3 indicates the current log sequence number. Refer 

(not displayed) to Chapter 15 of the ORACLE RDBMS Database 
Administrator's Guide for information about log 
sequence numbers. 


IF EXISTS %2 is a conditional statement to set the error level. If 

ERRLVL 0 %2, the destination file, is created successfully, 
then the ORA_ARCH.CMD file uses the ORACLE 
ERRLVL utility to set the error level to 0. An error 
level of zero indicates that the archiving process 
succeeded; a non-zero number indicates an error 
state. When ORACLE Database receives notice of 
an error state and there are no available redo logs, 
the database software stops processing and waits 
for the archiving process to succeed 
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Specifying Another CMD If you wish, you can use a .CMD file other than ORA_ ARCH.CMD. 

File or Executable You can also create and use an executable program to copy filled 
redo-log files. To do this, specify the file or program by setting the 
ORACLE_ARCH_COMMAND parameter in your CONFIG.ORA file. 
If you use an archiving program, be sure to include the .EXE extension 
with the filename in CONFIG.ORA. For example: 


ORACLE_ARCH_COMMAND = ARCH.EXE 
If you choose to use either another .CMD file or a separate archiving 
program, be sure to establish some level of error detection. This is 


done in the .CMD file by using the ERRLVL utility, or in the C 
language by using the EXIT (return code) function. 
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Backing Up and Recovering Files 


Using OCOPY to Make 
Online Backups 


os/2 | 


ORACLE Database for DOS and OS/2 support the backup (both online 
and offline) and recovery procedures discussed in Chapter 15 of the 
ORACLE RDBMS Database Administrator's Guide. 


When performing backup and recovery procedures under DOS, use the 
EXIT or HOST command in SQL*DBA to access the DOS prompt. Then 
use the COPY command as your operating system's file-copying utility. 
The COPY command can copy online database files under DOS. 


To back up or recover files with ORACLE Database for OS/2, either 
HOST or EXIT from SQL*DBA, or start an independent OS/2 
command session to access the OS/2 command line. For offline 
backups under OS/2, use the OS/2 COPY command. For online 
backups, use the ORACLE OCOPY utility, as described in the next 
session. 


To make an online or “hot” backup under OS/2, you must copy files 
that are still open and being used by the database. The OS/2 COPY 
command will not copy files that are open, so you must use the OCOPY 
utility provided with ORACLE Database. The OCOPY utility, located 
in \ORACLE6\BIN, can copy opened OS/2 files. 


The syntax for using OCOPY is 


OCOPY old_file new_file 


where: 
old_file is the name of the open file being backed up. 
new_file is the name for the backup copy of the file. 


OCOPY also accepts the command-line parameters a and size_1 [size_n]. 
These optional parameters are used by the ORAINST installation 
program. You should not use these options to make backups of 
database files. 


For complete instructions on making online backups, refer to Chapter 
15 of the ORACLE RDBMS Database Administrator's Guide. 
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CHAPTER 





PERFORMANCE 
TUNING 


his chapter discusses techniques that you can use to improve the 

performance of ORACLE Database for DOS and OS/2. It also 
discusses the ORACLE memory and process structures under these 
operating systems; knowledge of these structures is crucial to your 
understanding of performance-tuning issues. 


You should use this chapter in conjunction with the ORACLE RDBMS 
Performance Tuning Guide, which provides general tuning information 


for ORACLE under all operating systems. 


Performance Tuning 
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ORACLE Database for DOS Process Structure 


ORACLE Database for DOS is a single-task ORACLE database 

| DOS management system. In single-task ORACLE systems, the ORACLE 
Database program and a user program (such as an ORACLE tool) 

1 occupy a single process in shared memory. Each program has the 

| responsibility of maintaining a separation between itself and other 
programs. For example, the ORACLE software takes care not to write 
information in memory used by an ORACLE tool, and ORACLE tools 
| do not write information in memory used by the ORACLE Database 
software. 


| Single-task databases such as ORACLE Database for DOS are also 
single-process; they permit only one user connection at any given time. 
Single-process (also referred to as single-user) databases do not 
incorporate the five background processes discussed in Chapter 9 of 
the ORACLE RDBMS Database Administrator's Guide. For example, 
ORACLE Database for DOS does not write information from the 
database buffer or redo-log buffer pools according to an independent 
database writer (DBWR) process. Instead, the operations performed by 
the DBWR process (and the other ORACLE background processes) are 
carried out by the single process of the ORACLE Database for DOS 
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Transaction Handling 


ORACLE Database for DOS writes information to disk more frequently 
than other ORACLE databases. Because the System Global Area (SGA) 
under DOS is limited to 573 database buffers, less room is available to 
store and manipulate information from database tables. This increases 
the frequency of writing information to disk as SGA buffer space 
becomes needed for new transactions. 


SR AE 
ORACLE Database for OS/2 Process Structure 


0S/2 


FIGURE 8-2 
Two-Task Process 
Structure 


USER 
PROCESS 


SHADOW 
PROCESS 


ORACLE Database for OS/2 is a two-task ORACLE database. In 
two-task ORACLE systems, the ORACLE RDBMS and user programs 
(such as the ORACLE tools) occupy separate processes in the operating 
system. The separation between the different processes is maintained 
by the OS/2 operating-system software. 


ORACLE Database for OS/2 is also a multiple-process ORACLE 
database; it uses the five background processes discussed in Chapter 9 
of the ORACLE RDBMS Database Administrator's Guide. Because of this 
multiple-process architecture, the database software supports multiple 
user connections at any given time. However, ORACLE Database for 
OS/2 only supports multiple connections for processes initiated on 
your local computer. Database connections from remote computers 
(clients) are not supported. Because of this, ORACLE Database for 
OS/2 is referred to as a single-user database. 
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Consider Your 
Diagnostic Options 
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Guidelines for Tuning Single-User Databases 


The ORACLE RDBMS Performance Tuning Guide describes tuning 
techniques that can be applied to all ORACLE databases. However, 
many of these techniques address problems with multiple-user 
ORACLE systems. As single-user databases, ORACLE Database for 
DOS and OS/2 provide fewer options for performance tuning 
techniques. However, there are a number of guidelines that you 
should keep in mind when tuning a single-task ORACLE database. 


ORACLE provides a number of different tools for diagnosing database 
performance. These tools include: 


e the SQL trace facility 

e the TKPROF program 

e the EXPLAIN PLAN statement 
+ SQL*DBA MONITOR screens 


The SQL trace facility, TKPROF program, and EXPLAIN PLAN 
statement operate in the same manner under DOS and OS/2 as they do 
under any other operating system. Note, however, that the TKPROF 
program under DOS is limited to a maximum of 600 SQL statements. 


SQL*DBA MONITOR screens display information about database 
memory structures, input and output, and other internal operations. 
Most MONITOR screens display information about database resources 
at a particular point in time. However, other screens display statistical 
information for the current database session. In general, you should 
focus on statistical MONITOR screens and their related dynamic 
performance tables. Some of the most important MONITORs and 
tables under DOS and OS/2 relate to tuning memory allocation; these 
are described in Chapter 3 of the ORACLE RDBMS Performance Tuning 
Guide. 
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Avoid Tuning for 


Contention 


Consider Tuning 
Effects on Database 


Applications 


Example 


A large portion of the ORACLE RDBMS Performance Tuning Guide is 
devoted to tuning various types of database contention. Contention 
occurs when more than one user, or more than one process, attempts to 
access a single database resource. 


Because ORACLE Database for DOS and ORACLE Database for OS/2 
are single-user databases, contention for database resources is rarely a 
consideration. Thus, you can ignore many of the performance tuning 
topics related to contention. These topics include the following: 


e the row-level lock manager (contention for table data) 

e contention for rollback segments 

» free list contention 

e On-Line Transaction Processing (OLTP) tuning techniques 


Although some tuning issues may have little or no effect on a local, 
single-user ORACLE database, you may wish to consider those 
techniques in relation to your database applications. ORACLE 
applications can operate against remote ORACLE databases, and many 
applications can be ported to operate on different operating systems. 
Because of this, you should consider tuning your applications to take 
advantage of all ORACLE Version 6.0 features, regardless of whether 
your local database system will benefit. 


Consider the effects of tuning applications to take advantage of the 
Version 6.0 SEQUENCE generator; refer to Chapter 2 of the ORACLE 
RDBMS Performance Tuning Guide. 1f the application is run against a 
local, single-user database, the improved SEQUENCE generation may 
have very little effect on overall performance. However, if you port 
this application to operate against an ORACLE server, multiple users 
might operate the program at the same time. Under such 
circumstances, the use of the SEQUENCE generator may be necessary 
to avoid unnecessary waits for sequence numbers. For this reason, you 
should at least consider tuning your application to take advantage of 
the SEQUENCE generator. 
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Tuning SQL Statements and Applications 


ORACLE Database for DOS and OS/2 process SQL statements in the 
same manner as any other ORACLE database. Thus, tuning the syntax 
of SQL statements in a database application can improve database 
performance where complex queries are involved. 


Chapter 2 of the ORACLE RDBMS Performance Tuning Guide provides 
information about tuning SQL statements and applications. You can 
use all of the tuning techniques described in this chapter with ORACLE 
Database for DOS and OS/2. 


Note that tuning SQL statements and applications is generally the most 
efficient means of improving database performance. 


SS EAN R TR 
Using Disk Caches 


Disk caches use available memory to store information that is read 
from your hard disk. When an application (such as ORACLE) next 
requests this information, the data is read from memory instead of 
from your hard disk (see Figure 8-3). This reduces the time necessary 
to access data, and thereby improves the performance of your database. 


Disk caches are best used in conjunction with the standard database 
buffers and data-dictionary caches that comprise the System Global 
Area (SGA). These ORACLE memory structures work in the same 
manner as your operating system's disk caches. Database information 
is read into memory from disk and is stored there until the memory is 
needed for new information. 


Write Caches Write caches postpone the writing of information to disk by modifying 
cached information in memory. Write caches should never be used 
with ORACLE Database for DOS or ORACLE Database for OS/2 as 
they can corrupt your database files. 


DOS Caches ORACLE Database for DOS stands to benefit most from disk caches 
because its own data buffers are limited to a maximum of 573 database 
blocks. In other words, the ORACLE Database software can read only 

DOS 573 blocks of database information into memory at a given time, 
regardless of the memory available on your system. 
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FIGURE 8-3 
Disk-Cache Operation 





If you have large amounts of disk activity when using ORACLE 
Database for DOS, and if you have the required memory, it is in your 
best interest to supplement the SGA with a disk cache. Make the disk 
cache larger than the current SGA size. (The SGA size is displayed 
when you start up the database.) Refer to your DOS documentation for 
more information about creating disk caches. 


ORACLE Database for OS/2 provides more flexibility with regard to 
memory structures. Using INIT.ORA parameters, you can expand the 
number of database blocks in the System Global Area (SGA) to a 
maximum of 3449, provided you have enough memory available. To a 
large degree, this decreases the significance of disk caches because most 
caching can be performed by the database software itself. 
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If you wish to increase the size of the SGA, you can modify and use the 
sample INIT file, INITBIG.ORA. (If you have limited memory 
resources, you can decrease the SGA size with INITSML.ORA.) Refer 
to Chapter 10 for more information about the INIT.ORA file and these 
sample INTT files. 


Note that an excessively large disk cache or SGA can actually impair 
database performance under OS/2. Once the SGA or cache runs out of 
memory, OS/2 can “page” that information back to hard disk, thereby 
defeating the purpose of the memory structure. Refer to your OS/2 
documentation for more information about paging. 
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Tuning VO 


ORACLE Database for OS/2 is designed to benefit from each of the 


I/O tuning techniques discussed in Chapter 4 of the ORACLE RDBMS 
Performance Tuning Guide. 


ORACLE Database for DOS cannot write database information to 
multiple hard disks at the same time. Because of this limitation, much 
of the information discussed in Chapter 4 of the ORACLE RDBMS 
Performance Tuning Guide is inapplicable to ORACLE Database for DOS. 
Note, however, that you should tune your database to avoid dynamic 
extension. Refer to the section, “Avoiding Dynamic Space 
Management,” in Chapter 4 of that Guide for more information. 
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CHAPTER 


CUSTOMIZING 
OPERATING-SYSTEM 
PARAMETERS: 

THE CONFIG FILE 


A a user of the ORACLE Database under DOS or OS/2, you can 
customize your ORACLE Database configuration by changing the 
operating-system-parameter values defined in the CONFIG file. This 
chapter discusses the CONFIG file and its associated parameters. 
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How to Set CONFIG 
Parameters 





Setting Parameters in the 
Operating Environment 





A nates re ae 
| Modifying the CONFIG File 


When you install the ORACLE Database for DOS or OS/2 oran 
ORACLE tool, the software is configured to work on your machine 
using the default configuration parameters embedded in the software 
code. However, since computer hardware is so diversified, it is often 
necessary to customize the configuration of your software so that it 
works most efficiently with your computer. This tailoring is done 
using CONFIG files. 


A CONFIG file is a list of ORACLE parameters stored in an ASCII text 
file. The default CONFIG file, CONFIG.ORA, is installed in the 
ORACLE_HOME directory (usually \ORACLE6). The CONFIG.ORA 
file is read every time you start the ORACLE Database or an ORACLE 
tool. 


CONFIG parameters control such variables as the name of the 
ORACLE home directory, the method used to display output on the 
screen, and the command used to spool files to the printer. CONFIG 
parameters also determine the driver used for network 
communications and the values that SOL*Net should use for its 
operating parameters. (Refer to your SQL*Net documentation for 
descriptions of CONFIG parameters that affect the performance of 
SQL*Net.) 


The ORACLE Database and ORACLE Tools obtain CONFIG parameter 
values from one of three sources: the operating-system environment, 
the CONFIG file (usually CONFIG.ORA), and the default CONFIG 
parameter values. ORACLE sets CONFIG parameters only once, using 
the first source available. For example, if a CONFIG parameter is set in 
the operating-system environment, ORACLE ignores the CONFIG file 
entry and the default value for that parameter. 


You can set CONFIG parameters in the operating-system environment 
and in the CONFIG file. If you do not set a CONFIG parameter in one 
of these ways, ORACLE uses the CONFIG parameter’s default value 
listed at the end of this chapter. 


To set CONFIG parameter values in the operating-system 
environment, you use the SET command. For instance: 


C> SET ORACLE_TIO=BIOS 
When setting a CONFIG parameter, separate the parameter and its 


value with an equal sign only; do not include spaces between the 
parameter and value. 
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Setting Parameters in the 
CONFIG File 


Using Multiple CONFIG 
Files 


Parameters That Refer 
to Other Parameters 


Note: ORACLE Database for DOS reads CONFIG parameters from the 
operating environment only once, when you run ORACLE6.EXE. If 

you change CONFIG parameters in the operating-system environment 
during the course of an ORACLE session, the changes are not 
recognized by the database software until you next load 

ORACLE6.EXE into memory. 


To set CONFIG parameters in the CONFIG file, use a text editor to 
change or add the parameters in the default CONFIG.ORA file. For 
example, you could add the following line to your CONFIG.ORA file to 
set the ORACLE_TIO parameter: 


ORACLE_TIO=BIOS 


If you define a parameter two or more times in the CONFIG file, 
ORACLE uses only the first value. 


Note: The CONFIG file must have a blank line at the end. If no blank 
line exists, the last parameter specified in the CONFIG file is ignored. 


You can specify the CONFIG files that ORACLE products use by 
setting the CONFIG environment variable. The CONFIG variable 
defines the names and locations of CONFIG files on your system. To 
use the CONFIG environment variable, use the SET command at the 
command prompt or in your CONFIG.SYS file. Use the syntax: 


SET CONFIG=path[;path2] (;path3]... 
where path specifies the drive, directory path, and filename of distinct 


CONFIG files. For example, your SET command might designate two 
CONFIG files, as in: 


SET CONFIG=C: \ORACLE6 \CONFIG1.ORA;C: \ORACLE6 \CONFIG2 .ORA 


By default, the CONFIG variable points to the CONFIG.ORA file in 
your ORACLE home directory. 


Some of the parameters in the CONFIG file have values that refer to other 
parameters. For example, the UTILITY_MSG parameter defaults to: 


%ORACLE_HOME$% \$ORACLE_DBS% 
The percent (%) signs indicate that the value of another CONFIG 


parameter should be substituted into this parameter. In the example 
above, C:\ORACLE6 might be substituted for %ORACLE_HOME%. 


Note: The maximum length of a CONFIG parameter value is 255 
characters, after substituting values for parameters enclosed in percent 
(%) signs. 
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CONFIG Parameter Descriptions 


CONFIG_FILE (CONFIG) 


DBA_AUTHORIZATION 


DYNAMIC_MEMORY 
(DYN) 


DOS 


GDTSIZ 





DOS 


The following list describes the CONFIG parameters and their default 
values. It also discusses which values you can change, and explains 
why you might want to change them. 


Default: %ORACLE_HOME% \CONFIG.ORA 
Legal Values: One or more valid paths and ASCII filenames 


This parameter specifies the name and location of your ORACLE 
configuration file(s). The parameter should be set in your CONFIG.SYS 
file, or at your command prompt; it should not be included as a value 
in the ORACLE CONFIG file. 


Default: None 
Legal Values: Any continuous text string of up to 30 characters 


Specifies the DBA authorization password when operating SQL*DBA 
under DOS and OS/2. Note that setting this parameter circumvents 
ORACLE security by giving public access to system privileged 
commands. Refer to Chapter 5 for more information about the 
SQL*DBA authorization password. 


Default: All available memory 
Legal Values: 0 to 15,000 K 


Specifies a number of kilobytes (K) of extended memory that SOLPME 
reserves for ORACLE products. If you do not specify a value, or if you 
specify a value greater than the amount of extended memory available, 
SQLPME uses as much extended memory as is available. 


Default: 5,000 bytes 
Legal Values: 0-20,000 bytes 


GDTSIZ determines the size of the Global Descriptor Table. The global 
descriptor tables maps segments of DOS extended memory for 
SQLPME. SQLPME then uses the global descriptor table to load 
ORACLE software into extended memory. 


Using the default GDTSIZ of 5000, SQLPME can map enough memory 
to hold the ORACLE Database software and any one of the ORACLE 
tools. You may need to increase GDTSIZ if you plan to run a very large 
database application against a local ORACLE database. Setting 
GDTSIZ to a value smaller than 5,000 bytes is not recommended. 


9-4 ORACLE Database Installation and User’s Guide 











INTERRUPT 


LANGUAGE 


Default: 99 (63 hexadecimal) 
Legal Values: Any valid user software interrupt (96 to 103 decimal) 


Specifies the interrupt vector address that ORACLE will use. (Also 
refer to the XMMITR parameter.) 


Note: You should not reset this address unless it conflicts with other 
terminate-and-stay-resident (TSR) or background programs. 


Default: american_america.US7ASCII 
Legal Values: See the accompanying Release Notes for a current list of 
available values. 


The LANGUAGE parameter sets the language in which message files 
appear. The syntax for LANGUAGE is as follows: 


LANGUAGE = <language>_<territory>.<char_set> 


where: 

<language> specifies the language and its conventions for 
displaying messages and day and month names. 

<territory> specifies the territory and its conventions for 
calculating week and day numbers. 

<char_set> specifies the character set used for the UPPER, 


LOWER, and INITCAP functions, and the type of 
sort used by an ORDER BY query. This argument 
also controls the character set used for displaying 
messages. 


When you run ORAINST, you are prompted to specify the language 
argument. The installation procedure will then set the LANGUAGE 
parameter with the corresponding default values for the territory and 
character set. For example, if you select “german” from the list of 
values on the screen, then the installation procedure resets the default 
values of the LANGUAGE parameter as follows: 


LANGUAGE = german_germany .WE8PC850 


Alternatively, you can manually specify values for territory and 
character set. See the accompanying Release Notes for legal values. 

Note: The value of the LANGUAGE parameter in your CONFIG.ORA 
file should match that of the LANGUAGE parameter in your INIT.ORA 
file. Refer to Chapter 10 for information about modifying the 

INIT.ORA file. In addition, refer to the ORACLE RDBMS Database 
Administrator's Guide for a discussion of INIT.ORA parameters. 
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The default setting for LANGUAGE is American. 


LOCAL (LOC) Default: S: for DOS 
2: for OS/2 


Legal Values: Any valid SQL*Net driver prefix, including 
database-string parameters 


This parameter specifies the SQL*Net driver and complete connect 
string to use when no communications driver is specified upon starting 
an ORACLE tool. The parameter enables you to define a “default” 
network connection. When a user logs on without specifying network 
parameters, ORACLE uses the LOCAL connection. 


For information about connect strings that are valid for DOS and OS/2, 
refer to the Getting Started booklet for your SQL*Net driver. 


MACHINE_TYPE Default: None 
—— Legal values: A valid MACHTYPE machine-type code 
DOS The MACHINE_TYPE parameter specifies the model of your hardware 


(CPU) system. This parameter is used by SQLPME to properly switch 
to protected mode on your system. MACHINE_TYPE is set when you 
install the Required Support Files disk. You can also set this parameter 
by running the utility MACHTYPE from the command line. 
MACHTYPE is installed with your ORACLE utilities. 


Once you select a hardware model using the MACHTYPE utility, the 
MACHINE_TYPE parameter is set to the number or letter assigned by 
ORACLE to the hardware model you selected. For example, if you 
select “COMPAQ 386/20” as your hardware model, 
MACHINE_TYPE=2 will be set in your CONFIG.ORA file. 


Note: You must have set MACHINE_TYPE to the correct choice before 
SQLPME is loaded to run the ORACLE tools in protected mode. 
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MISSING_CONFIG_ 
ERROR 


ORACLE_ARCH_ 
COMMAND 


0S/2 


| ORACLE_DBS 
(ORACLE_D) 


ORACLE_HOME 
(ORACLE_H) 


ORACLE_MSG 





Default: FALSE 
Legal Values: | TRUE or FALSE 


This parameter specifies whether or not a fatal error occurs when an 
ORACLE product cannot access a specified CONFIG file. For example, 
if the CONFIG_FILE parameter specifies two CONFIG files and only 
one is found, the ORACLE product will display an error and the tool 
will not be started. 

Default: CMD.EXE /C ORA_ARCH.CMD 

Legal Values: A valid OS/2 executable or .CMD file 


This parameter specifies the program file (executable file or command 
file) to use when archiving filled online redo-log files. Refer to 
Chapter 7 of this Guide for more information. 


Default: DBS 

Legal Values: A valid directory name 

This parameter specifies the subdirectory in the ORACLE_HOME 
directory where the ORACLE database and other files are stored. 
Default: \ORACLE6 on the default ORACLE drive 

Legal Values: Any directory on any drive 


This parameter specifies the “home directory” in which ORACLE is 
installed. ORACLE_HOME is added to your CONFIG file when you 
run ORAINST for the first time. The value of ORACLE_HOME is the 
top directory in the ORACLE directory hierarchy. 


Default: %ORACLE_HOME%\%ORACLE_DBS% 
Legal Values: Any directory 


This parameter specifies a directory where error messages used by 
ORACLE audit tools and utilities are kept. You can use ORACLE_MSG 
to distinguish between two sets of message files. 
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ORACLE_SPOOLER 
(ORACLE_S) 


ORACLE_TIO 
(ORACLE_T) 





Default: PRINT 
Legal Values: Any valid command to spool files to the printer 


This parameter specifies the command used by ORACLE tools to send 
files to the printer. When an ORACLE tool attempts to spool a file 
name, ORACLE fulfills the request by executing the following, 
command: 


ORACLE_SPOOLER=FILENAME 


For example, if the value of ORACLE_SPOOLER is the default PRINT, 
and an ORACLE tool attempts to spool a file named RESULTS.DAT, 
ORACLE fulfills the request by issuing the following command: 


PRINT RESULTS.DAT 


Default: VIDEO 
Legal Values: | VIDEO, BIOS, ANSI 


The ORACLE_TIO parameter specifies the output technique that 
certain ORACLE tools (such as SQL*DBA) use for writing to the 
display. You should attempt to use the fastest output technique that is 
compatible with your machine. Start with ORACLE_TIO=VIDEO. If 
VIDEO does not work properly, try BIOS, and finally, ANSI. 


The ANSI value specifies output with ANSI standard escape 
sequences. ANSI is the least efficient mode of output. However, ANSI 
makes the lowest demands on a computer's IBM compatibility. If you 
use ANSI output, you should also load the ANSI.SYS driver. With 
DOS, you can load the driver automatically at startup time by adding 
the following line to your CONFIG.SYS file: 


DEVICE=C: \DOS\ANSI.SYS 
With OS/2, you can load the driver by typing: 
[C:\] ANSI ON 


If you use ANSI output, you should also replace your DEFAULT.CRT 
file. Simply copy the file named ANSI.CRT to the new filename, 
DEFAULT.CRT. 
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REAL_MEMORY 


Example: 


Example: 


Default: None 


Legal Values: any application tool name, OTHER; Real memory 
allocation limit is 640K 


The REAL_ MEMORY parameter allows you to use some specified 
allocation of real memory (memory below the 640K limit) as working 
memory for a protected-mode ORACLE tool. This parameter is 
invoked by SQLPME when you issue the command to start the 
ORACLE tool. 


The REAL_MEMORY command syntax is 
REAL_MEMORY= [application_name:]memory_allocation[;...] 
where: 


application_name is the name of an ORACLE executable file, or 
OTHER. OTHER indicates all ORACLE 
applications not specified. 


memory allocation is the number of kilobytes of real memory to 
allocate for use as protected-mode workspace. 


REAL_MEMORY=SQLForms : 100K; SQLPlus: 200K; OTHER: 25K; 


In this example, 100K of memory below 640K will be used by 
SQL*Forms when it runs in protected mode, 200K of memory below 
640K will be used by SQL*Plus in protected mode, and 25K of memory 
below 640K will be used by all other applications when they run in 
protected mode. 


If an application name is not present, OTHER is assumed. 


REAL_MEMORY=100K 


In this example, 100K of the memory below 640K will be used by each 
application running in protected mode. 


Note: Use of this parameter limits memory available below 640K only 
while the specified application is running. It is recommended that you 
check your system's available “real” memory prior to setting this 
parameter. Use the DOS CHKDSK command to check your system's 
available memory. Refer to your DOS reference manual for further 
details. 
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REMOTE (REM) 


SQLNET 


USERNAME (USER) 


Default: A: 
Legal Values: Any valid SQL*Net connect string. Refer to your 
SQL*Net documentation for more information. 


This parameter enables you to define a “default” remote network 
connection. Ifa user logs on and specifies a driver prefix with no 
parameters, ORACLE uses the parameters associated with that prefix in 
the value of REMOTE. For example, if the value of REMOTE were 
X:server, a user could log onto the specified server using only the prefix X:. 


Default: None 


Legal Values: Any valid network alias /network prefix combination 


The SQLNET parameter allows you to set a unique alias for each server 
on your network or distributed network. By setting multiple aliases, 
you can refer to connect strings by simple names or mnemonic 
conventions; you need not remember the complete connect string for 
each one. The general syntax for SQLNET is: 


SOLNET DBNAME server_alias=connect_stri ng 


To use the server specified in SQLNET, you must enter the alias. For 
example, if you had set 


SQLNET DBNAME Mktg_SRV=X:Serverl 
you would access the database from within SQL*DBA by typing: 


SQLDBA> CONNECT SCOTT/TIGER@Mktg_SRV; 


You can include multiple SQLNET parameters in the CONFIG.ORA 
file to define multiple network aliases. 


Note: The SQLNET parameter applies only to Version 6.0 ORACLE 
tools, such as SQL*DBA. 
Default: None 


Legal Values: Any valid OPS$ account username (without the OPS$ 
prefix) 


USERNAME specifies the variable part of an OPS$ account username. 
Refer to Chapter 5 of this Guide for more information. 
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Legal Values: Any directory 


This parameter specifies a directory where error-message files used by 
ORACLE audit tools and utilities are kept. 


You can have more than one set of message files and use this parameter 
to change the set for a particular configuration. 


| - XMMITR Default: 100 decimal (64 hexadecimal) 
| Legal Values: Any valid interrupt vector (96-103) 


DOS XMMITR (Extended-Memory-Manager Interrupt Vector) isa variable 
that indicates the interrupt vector that is to be used for the extended 
memory-manager/mode-transition driver (XMM/MTD) interrupt 
services entry point contained in SQLPME. 

| | Enter a new interrupt vector as a decimal number. XMMITR should be 


used only if another program in your system needs to use interrupt 100 
| decimal (or 64 hexadecimal). Also refer to the INTERRUPT parameter. 





UTILITY_MSG (UTIL) Default: %ORACLE_HOME%\%ORACLE_DBS% 
| 
| 
| 
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CHAPTER 


CUSTOMIZING 
DATABASE 
PARAMETERS: 
THE INIT FILE 


he standard ORACLE system you installed in Chapter 3 may suit 

your needs for a long time, particularly while you are learning to 
use the ORACLE Database software. However, you may eventually 
want to customize your system by modifying database parameters 
contained in the INIT file. This chapter discusses the INIT file and its 
associated parameters. 
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AA] 
Modifying the INIT File 


How to Set INIT 
Parameters 


Using Default Values 


Parameters That Refer 
to Other Parameters 


Every time you start up an ORACLE database, the ORACLE software 
reads a set of initialization parameters. These initialization parameters 
determine how the database will operate. For example, some 
parameters define how much memory the database will use. Other 
parameters determine whether or not filled online redo logs are 
archived. 


The initialization parameters are found in files commonly referred to as 
INIT files. An INIT file is a short ASCII text file that contains a list of 
parameters and values. With ORACLE Database for DOS and 
ORACLE Database for OS/2, the default INIT file is called INIT.ORA 
and is stored in the \DBS subdirectory. 


You can customize INIT parameters by changing their values in the 
INIT file. The following is the syntax for each parameter: 


parameter=value 


For example, to change the parameter OPEN_CURSORS to 32, set the 
OPEN_CURSORS line of INIT.ORA to the following: 


OPEN_CURSORS=32 


You can also rename your default INIT.ORA file or create several 
different INIT files with different names. In this way, you can identify 
the file you wish to use when you issue the SOL*DBA STARTUP 
statement. To start the ORACLE Database software with an INIT file 
other than INIT.ORA, use the PFILE option in the statement 


SQLDBA> STARTUP PFILE=filename 


where filename is the name of the INIT file to be used. 


You can use the default value of an INIT parameter by omitting that 
parameter from your INIT file. 


Some of the parameters in the INIT file can have values that refer to 
other parameters. For example, the default value of the 
CONTROL_FILES parameter is: 


CONTROL_FILES=%ORACLE_HOME% \$ORACLE_DBS$\CONTROL1.ORA 
The percent (%) signs surrounding %ORACLE_HOME% and 


%ORACLE_DBS% indicate that the value of these parameters should 
be substituted in the final path definition. 
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The Sample INIT Files 


FIGURE 10-1 
Sample INIT.ORA File 
for DOS 


FIGURE 10-2 
Sample INIT.ORA File 
for OS/2 





When you install the initial database with the ORACLE Database 


software a sample INIT file, INIT.ORA, is copied to your hard disk. 
This sample INIT file sets values for INIT parameters where default 


values are not appropriate for your database. For this reason, you 


should use the sample INIT.ORA file as a basis for creating customized 
INIT files. If you accidentally remove the sample INIT.ORA file or any 
of its parameters, you should replace the file or parameter immediately. 


Figures 10-1 and 10-2 list the contents of the sample INIT.ORA files. 


Note that the sample files are installed in the \DBS subdirectory of 
your ORACLE home directory. 


# database writer/file parameters 
db_block_size = 1024 
db_block_buffers = 63 
db_file_multiblock_read_count = 8 
db_name = ORACLE 


# dictionary cache parameters 
dc_column_grants = 100 


# redo log writer/file parameters 
log_allocation = 1000 


# miscellaneous parameters 

ddl_locks = 250 

row_locking = INTENT 

use_row_enqueues = false 

transactions = 20 

enqueue_resources = 85 

rollback_segments = (system_rs, users_rs) 


$ database writer/file parameters 
db_block_buffers = 550 
db_file_multiblock_read_count = 8 
db_name=oracle 


# dictionary cache parameters 
dc_column_grants = 150 
dc_columns = 700 
dc_constraint_defs = 600 
dc_constraints 450 
dc_files = 75 
dc_free_extents = 150 
dc_indexes = 150 
de_object_ids = 150 
dc_objects = 300 
dc_rollback_segments = 75 
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FIGURE 10-2 
(continued) 


Additional Sample 
INIT Files 


os/2 


dc_segments = 150 
dc_sequence_grants = 60 
dc_sequences = 60 
dc_synonyms = 150 
dc_table_grants = 150 
dc_tables = 150 


db_name = oracle 
db_block_buffers = 60 
log_checkpoint_interval = 10000 
ddl_locks = 100 

dml_locks = 100 

processes = 20 


dc_tablespace_quotas = 75 
dc_tablespaces = 75 
dc_used_extents = 150 
dc_usernames = 150 
dc_users = 150 


# redo log writer/file parameters 
log_allocation = 1000 

log_buffer = 64512 
log_checkpoint_interval = 10000 


# row cache parameters 
row_cache_enqueues = 300 


$ sequence cache parameters 
sequence_cache_entries = 30 
sequence_cache_hash_buckets = 23 


# miscellaneous parameters 
processes = 50 
rollback_segments = (system_rs, users_rs) 


ORACLE Database for OS/2 includes three additional INIT files. They 
are: 

e INITSML.ORA 

e INITMED.ORA 

e INITBIG.ORA 
The INITSML.ORA file utilizes very little of your system resources. If 


you have limited memory in your system, you may wish to modify and 
use this INIT file. 
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The INITMED.ORA file is essentially the same as the sample INIT.ORA 
described in Figure 10-2. However, INITMED.ORA does not contain 
the ROLLBACK_SEGMENTS parameter, which is required for the 
initial database. 


INITBIG.ORA is a sample INTT file that has been customized to acquire 
more system resources for your database. If you wish to increase the 
capacity of your ORACLE Database for OS/2, use this file as a model. 


Note: None of the additional sample INIT files includes the 
ROLLBACK SEGMENTS parameter, which lists private rollback 
segments for the database. If you wish to use one of the additional 
INIT files with a customized database, first modify the file to include all 
private rollback segments in the ROLLBACK SEGMENTS parameter. 


CSS Sn ss ernennen Zune 
INIT Parameter Descriptions 


This section lists the INIT parameters that have special characteristics 
under DOS or OS/2. These parameters may have default values or 
ranges that differ from those listed in the ORACLE RDBMS Database 
Administrator's Guide. 


If the sample INIT.ORA file included with the ORACLE Database gives 
an INIT parameter a special value, do not delete that parameter from 
the file. Ifyou do, ORACLE uses the default value listed in the 
ORACLE RDBMS Database Administrator's Guide; this may be 
inappropriate for your system. For a complete description of all the 
INIT.ORA parameters, refer to Appendix D of that Guide, “The INIT.ORA 
Parameters.” 


Note: Some parameters are noted as derived. This means that their 
values are calculated from the values of other parameters. In most 
cases you should not alter values for derived parameters. However, if 
you do modify such a parameter, the value that you specify overrides 
the calculated value. 





You can display the current value of an INIT parameter by typing 


SQLDBA> SHOW PARAMETER name 


where name is a full or partial parameter name. 
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TABLE 10-1 





INIT.ORA Parameters 

DOS DOS OS/2 OS/2 
Parameter Name Default Range Default Range 
1 BACKGROUND_DUMP DEST None A valid directory None A valid directory 
CALLS Derived 0-1200 Derived Do not change 
CONTEXT_AREA 4096 1024-65535 4096 1024-65280 
CONTEXT_INCR 4096 1024-32767 4096 1024-32767 
CONTROL, FILES 2CONTROLL.ORA 1108 filenames 2CONTROLI.ORA 1108 filenames 
CPU_COUNT 0 0 0 0 
DB_BLOCK_BUFFERS 32 4-573 32 4-3449 
DB_BLOCK_COMPUTE_CHECKSUM FALSE TRUE/FALSE FALSE TRUE/FALSE 
DB_BLOCK_HASH_BUCKETS Derived 0-65535 Derived 0-65535 
DB_BLOCK_SIZE 1024 1024 2048 1024-4096 
DB_FILE_MULTIBLOCK READ COUNT Derived 0-65535 Derived 1-31 
DC_COLUMN_GRANTS 50 0-1000 50 1-1000 
DC_ COLUMNS 300 0-800 300 150-800 
DC_CONSTRAINT_DEFS 200 0-800 200 1-450 
DC_CONSTRAINTS 150 0-450 150 1-450 
DC FILES 25 0-550 25 1-550 
DC_FREE_EXTENTS 50 50-550 50 5-550 
DC_INDEXES 50 0-1000 50 20-1000 
DC_OBJECT_IDS 50 0-450 50 1-450 
UC OBJECTS 100 0-400 100 50-400 
DC_ROLLBACK_SEGMENTS 25 0-400 25 2-400 
DC_SEGMENTS 50 50-450 50 50-450 
DC_SEQUENCE_GRANTS 20 0-1700 20 2-1700 
DC_SEQUENCES 20 0-275 20 2-275 
DC_SYNONYMS 50 0-300 50 2-300 
DC_TABLE_GRANTS 50 0-1700 50 2-1700 
DC_TABLES 100 0-375 100 30-375 
DC_TABLESPACE QUOTAS 25 0-500 25 1-500 
DC_TABLESPACES 25 0-200 25 2-200 
DC_USED_EXTENTS 50 50-500 50 50-500 
DC_USERNAMES 50 0-450 50 1-450 
DC_USERS 50 0-350 50 1-350 
DDL_LOCKS Derived 0-1300 Derived 20-1300 








Nie this parameter is not set to a valid directory, trace files or alert files are not generated. If the parameter is set, one 
trace file and one alert file is generated each time you start ORACLE Database. This parameter is used in conjunction 
with the parameter, USER_DUMP_DEST. See the ORACLE RDBMS Database Administrator's Guide for more 


information about trace and alert files. 


2 %ORACLE_HOME%\%ORACLE_DBS% \ filename 
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TABLE 10-1 (continued) 





INIT.ORA Parameters 

DOS DOS OS/2 OS/2 
Parameter Name Default Range Default Range 
DML_LOCKS Derived 0-750 Derived 0, 20-750 
ENQUEUE_RESOURCES Derived 0-850 Derived 10-850 


INIT_SQL_FILES 
LOG_ARCHIVE_DEST 
LOG_ARCHIVE_START 
LOG_BLOCKS_DURING_ BACKUP 
LOG_BUFFER 
LOG_CHECKPOINT_INTERVAL 
LOG_ENTRY_PREBUILD_THRESHOLD 
LOG_FILES 

LOG_IO_SIZE 
LOG_SIMULTANEOUS_COPIES 
LOG_SMALL_ENTRY_MAX_SIZE 
PROCESSES 
ROW_CACHE_ENQUEUES 
ROW_LOCKING 
SEQUENCE_CACHE_ENTRIES 
SEQUENCE_CACHE_HASH_BUCKETS 
SESSIONS 

SORT_AREA_SIZE 
SORT_READ_FAC 
SORT_SPACEMAP SIZE 
TRANSACTIONS 


TRANSACTIONS_PER_ROLLBACK- 
_SEGMENT 


3USER_DUMP_DEST 


INSQL.BSQ A valid path and file 
1\ ARC.ORA A valid path and file 


2TRUE 
TRUE 
8192 
80 


100 
ALWAYS 
10 

7 

Derived 
9216 

5 

256 
Derived 


30 
None 


2TRUE 
TRUE/FALSE 
0-65280 
20-unlimited 
0-65380 

2-255 

0 

1 

0-800 

0-2 

0-1900 
ALWAYS/INTENT 
0-500 

0-7500 

0-10 
9216-65472 
Do not change 
256-65472 
0-750 


1-unlimited 
A valid directory 


INSQL.BSQ A valid path and file 
1\ ARC.LOG A valid path and file 


FALSE 
TRUE 
16384 
32 


100 


10 


256 
Derived 


30 
None 


TRUE/FALSE 
TRUE/FALSE 
512-65280 
20-unlimited 
0-65280 

2-255 

0 

1 

Do not change 
5-7 

1-1900 
ALWAYS/INTENT 
10-555 

1-7500 

11-122 
9216-65472 

Do not change 
256-65472 
27-819 


1-unlimited 
A valid directory 





; %ORACLE_HOME%\%ORACLE_DBS% \ filename 


2L0G_ARCHIVE START is considered “TRUE” under DOS regardless of the parameter's value, 


3If this parameter is not set to a valid directory, trace files or alert files are not generated. If the parameter is set, one 
trace file and one alert file is generated each time you start the ORACLE Database. This parameter is used in 
conjunction with the parameter, BACKGROUND_DUMP_DEST. See the ORACLE RDBMS Database Administrator's 
Guide for more information about trace and alert files. 
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CHAPTER 


USING SOL*LOADER 


his chapter provides DOS- and OS/2-specific instructions for using 

the SOL*Loader DB3PREP, 123PREP, and ASCPREP utilities. 
These utilities enable you to load data from dBASE III PLUS, Lotus 
1-2-3, and ASCII text files into your ORACLE database. Refer also to 
Appendix C of this Guide for descriptions of error messages that can 
occur while using these utilities. 


Note: To learn how to use SQL*Loader and to familiarize yourself with 
SQL*Loader terminology, refer to the ORACLE RDBMS Utilities User's 
Guide. 
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What Is SOL*Loader? 


SQL*Loader is the ORACLE application-development tool for moving 
external file data into tables in an ORACLE database. SQL*Loader 
loads data in a variety of formats, performs filtering (selectively 
loading records based on data values), and loads multiple tables 
simultaneously. It has many of the same features as the IBM DB2 load 
utility and includes several other features that extend its power and 
versatility. Using SQL*Loader, you can: 


e load data from multiple data files of different file types 


e handle fixed-format, delimited format, and variable-length 
records 


e load multiple tables during the same run, and selected rows 
into each table 


e combine multiple physical records into a single logical record 


Limitations under DOS Under DOS there is a size limit of 64,000 bytes for the bind array used 

by SQL*Loader to pass data to memory. This does not affect the use or 

performance of SQL*Loader since it automatically limits the bind array 

DOS size if you do not set the ROWS or BINDSIZE parameters. However, if 
you set the BINDSIZE parameter to a value that forces the bind array to 
be larger than 64K, you will receive an error. If you set the ROWS 
parameter to a value that forces the bind array to be larger than 64,000 
bytes, the number of ROWS is reduced automatically to keep the bind 
array under 64,000 bytes. 
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Using SOL*Loader with dBASE III PLUS Files 


Using DB3PREP 


The DOS and OS/2 versions of SOL*Loader (Version 1.0) can import 
data directly from dBASE III PLUS files into an ORACLE database. 
This capability is automatically invoked whenever the SQL*Loader 
INFILE control statement references a file with an extension of .DBF. 
Loading from dBASE III PLUS files is supported only with the 
fixed-format facility of SQL*Loader. 


Loading data from a complex dBASE III PLUS file can require a lengthy 
data definition in the SQL*Loader control file. To assist in the 
preparation of the SQL*Loader control file, a special utility program 
called DB3PREP is included with SQL*Loader. 


dBASE III PLUS files that contain multiple memo fields are treated 
differently from other dBASE III PLUS files. When there is more than 
one memo field, a separate ORACLE table is created for each memo 
field and these tables are related to the base table. Each of these memo 
tables has two columns: a sequence number and the actual memo (a 
column of datatype LONG). In the base table where the rest of the DBF 
file has been loaded, the memo fields are referred to by the memo's 
new table name and the respective sequence numbers. These 
additional memo tables are named according to the base table’s name 
and the column name of the memo field from the .DBF file. 


DB3PREP creates both a .SQL file to define the ORACLE table 
corresponding to the dBASE III PLUS file, and a .CTL file to load the 
data into the ORACLE table. The .SQL file is used by SQL*Plus or 
SQL*DBA and the .CTL file is used by SQL*Loader. If a subset of the 
dBASE III PLUS file is to be loaded, you may edit the SQL and .CTL 
files before invocation to define the subset to be loaded. 


Note: Before executing DB3PREP, be aware of the following important 
limitations: 
e Character fields must be less than 255 characters long 
(ORACLE supports only character fields up to 255). 
e Logical fields will be converted to CHAR(1) fields. 


e Do not use any ORACLE reserved words as field names. (Refer 
to the SQL Language Reference Manual for further information 
about ORACLE reserved words.) 
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DB3PREP is invoked from the DOS or OS/2 command line, thus 


C> DB3PREP dbffile 


where dbffile is the name of a dBASE III PLUS .DBF file. 


Caution: If the .DBF file has the same name as a table already existing in 
your database, the new records from the .DBF file are inserted into the 
existing table. Because no check is made, this could result in duplicate 
records. 


The following is an example of the screen output from DB3PREP: 


dBase III file name is EMP.DBF 
last update was on 03/04/91; 
there are 14 records in the file; 
the header length is 290 bytes; 
the record length is 52 bytes. 
dbf field information: 


Table name: EMP 
field name type length decimal 


EMPNO 
ENAME 
JOB 

MGR 
HIREDATE 
SAL 

COMM 
DEPTNO 





N 
c 
C 
N 
D 
N 
N 
N 


osoaurwmwe3ı 
NZIJOo» OPA 
onvooooo 


EMP.SQL and EMP.CTL created 


The type codes in the above example are N for numeric field, € for 
character field, and D for date field. 


This example creates the following .SQL file, EMP.SOL: 


CREATE TABLE EMP 
(EMPNO NUMBER (4), 
ENAME CHAR (10), 

JOB CHAR (9), 

MGR NUMBER (4), 

HIREDATE DATE, 

SAL NUMBER (7,2), 

COMM NUMBER (7,2), 

DEPTNO NUMBER (2)) ; 
EXIT 


11-4 ORACLE Database Installation and User's Guide 








Using SQL*Loader 
with the DB3PREP 
.CTL File 


You can use this .SQL file with SOL*Plus or SOL*DBA to create the 
table that matches the dBASE data file description. Invoke SQL*Plus 
using the syntax: 


C> SQLPLUS username/password [@command_filename] 
In our example, you would invoke SQL*Plus by entering: 
C> SQLPLUS SCOTT/TIGER @EMP 


The above example creates the following .CTL file: 


LOAD DATA 

INFILE "EMP.DBF" FIXED 52 

APPEND 

INTO TABLE EMP 
(EMPNO POSITION(2:5) INTEGER EXTERNAL, 
ENAME POSITION(6:15) CHAR, 
JOB POSITION(16:24) CHAR, 
MGR POSITION(25:28) INTEGER EXTERNAL, 
HIREDATE POSITION (29:36) DATE 'YYYYMMDD', 
SAL POSITION (37:43) DECIMAL EXTERNAL, 
COMM POSITION (44:50) DECIMAL EXTERNAL, 
DEPTNO POSITION (51:52) INTEGER EXTERNAL) 


Note the date format for the HIREDATE field. You must convert 
dBASE III PLUS dates to ORACLE date format. Refer to the ORACLE 
RDBMS Utilities User's Guide for information about converting dates 
into ORACLE format. 


You can use the .CTL file with SQL*Loader to load the data from the 
dBASE III PLUS .DBF file into the ORACLE database. Invoke 
SQL*Loader as follows: 


C> SQLLOAD username/password tablename[.ctl] 


In this example, type: 
C> SQLLOAD SCOTT/TIGER EMP.CTL 


If you want to load data only from selected fields in each dBASE II 
PLUS record, delete the corresponding field definitions from the .SQL 
and .CTL files. For example, if you do not want to load the JOB and 
COMM fields, use a text editor (such as EDLIN) to delete the lines for 
JOB and COMM from both the .SQL and .CTL files. Note that this 
feature applies only to dBASE III PLUS files. 


If you want to change the names of any fields before loading, edit the 
SQL and .CTL files and type over the names of the fields that you want 
to change. 
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Using the DB3LOAD Under DOS, a batch command file, DB3LOAD.BAT, is provided with 

File SQL*Loader to run the three utilities (DB3PREP, SQLPLUS, and 
SQLLOAD) as a single command. Under OS/2, the file is called 
DB3LOAD.CMD. Use the syntax 


C> DB3LOAD username password dbffile 


where dbffile is the name of the dBASE III PLUS .DBF file to be loaded. 
The example would be invoked as: 


C> DB3LOAD SCOTT TIGER EMP 
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Loading Ranges of 
Lotus 1-2-3 Data 








Using SQL*Loader with Lotus 1-2-3 Files 


Lotus 1-2-3 data files have a unique format. Files in this format cannot 
be directly loaded into the ORACLE database. The 123PREP utility, 
however, will convert 1-2-3 spreadsheet files into a format compatible 
with SQL*Loader. 123PREP will create a SQL file to assist in creating 
an ORACLE table with SQL*Plus and a .CTL file to load the data into 
the table with SQL*Loader, and a .DAT file that contains the data 
extracted from the spreadsheet. 


In addition to these functions, 123PREP has several options that you 
can invoke from the command line. These options give you greater 
control over the translation procedure, and allow you to create 
corresponding tables and load data at the same time. These options are 
described in more detail later in this section. 


Notes: SQL*Loader can only load files from Lotus 1-2-3, Version 2.2 or 
earlier (.WK1 or .WKS files). SQL*Loader can load Lotus 1-2-3 Release 
3.0 files (.WK3 files) if you first save the worksheet as a .WK1 file. You 
can also use the Lotus Translate utility to convert a .WK3 file to .WK1 
format. Refer to your Lotus 1-2-3 documentation for information about 
saving your files in .WK1 format. 


If you do not want to load all the data from the spreadsheet, you have 
two options: 


+ Use the /File Xtract Values command in 1-2-3 to save the 
desired range in a separate file. 


e Use the /Range Name Create command in 1-2-3 to name the 
desired range. Then, select that range during 123PREP. 


Using SQL*Loader 11 





-7 














Guidelines for 
Translating 
Lotus 1-2-3 Files 


Use the following rules to help you when loading the data in your 
spreadsheet file into the ORACLE database. 


Ensure that the file (or range) to be loaded is in database form. 
This means that each column should have a column name at 
the top, and each column should contain only one datatype. If 
conflicting datatypes occur in a single column, 123PREP turns 
the column into a character column in order to resolve the 
conflict. 


Delete all column headings and other such text not relevant to 
the data to be loaded. In addition, keep irrelevant data and 
non-data elements out of the range that you want to load. 
123PREP considers the first row containing a label cell to be the 
row that contains all the column names. 


Verify that column names are unique. Remember that column 
names are not case-sensitive in ORACLE unless enclosed in 
quotes. This means 1-2-3 labels such as Empno, empno, and 
EMPNO would yield the same column names. Also, be sure 
not to use SQL*Plus or SQL*Loader reserved words as your 
column names. (Refer to the SQL*Plus Quick Reference and 
Appendix D of the ORACLE RDBMS Utilities User's Guide for 
reserved words.) 


Verify that all numeric data has been formatted in the 
worksheet. 123PREP uses the range format of the first cell 
containing data to define the datatype of the destination table 
column. For example, a column containing numeric data in 
the worksheet is formatted to show 4 decimal places. When 
this data is prepared by 123PREP, the destination table column 
will be defined with 4 decimal places. If the numeric data in 
the worksheet is not formatted, it will be truncated to 2 
decimal places. 

Try to use the same formatting options on data in a given 
column whenever possible. Although 123PREP will write the 
data to the data file in the format you specify, you should be 
consistent. 
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Using 123PREP 


The Options Parameter 


To invoke the 123PREP utility from the command line, type the 
following command: 


C> 123PREP [-options] [userid] filename[.ext] 


Although the parameters enclosed in brackets are optional, some 
features of 123PREP will not be available to you unless they are 
specified. 


The options parameters act as toggle switches. Refer to the following 
section for more information. 


The userid parameter is your ORACLE username and password, 
separated by a slash. For example, if your username is SCOTT and 
your password is TIGER then the userid parameter is SCOTT/TIGER. 
If this parameter is not specified, 123PREP does not invoke either 
SQL*Plus or SQL*Loader, since these programs require the 
username/ password specifications. 


The filename parameter is the Lotus 1-2-3 file to be translated. The 
extension, if specified, must be either .WKS or .WK1, depending on the 
1-2-3 release with which you created the file. If the extension is not 
specified, 123PREP asks you which release of 1-2-3 you are using and 
appends the appropriate extension. The filename parameter may 
include a path and drive specification. The table name created in your 
database is derived from the filename, minus the path specification and 
filename extension. 


The options parameter should consist of a hyphen (-) followed by the 
letters of the desired options, with no intervening spaces (123PREP 
interprets spaces in the options parameter as separate command-line 
arguments). Valid options are: 


C Create and then load (no translate) 


This option skips translation of the 1-2-3 file to.SQL and .CTL files 
and goes straight to the creation (SQL*Plus) and loading 
(SQL*Loader) phases. To use this option, you must have existing 
SQL and .CTL files corresponding to the specified filename. This 
option cannot be used with the -D option. 


D Drop table and create new table 


This option drops a table and its associated data, and creates a new 
table with the same name. The default (not specifying this option) 
appends the data to the existing table if the old table and the new 
table have the same column specifications. This option cannot be 
used with the -C option. 
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More about Using 
123PREP 


R Remove file 


This option deletes the SQL*Loader files *.LOG, *.BAD, and *.DAT, 
and the .SQL and .CTL files. Because it may be difficult to track 
errors when these files are not present, use this option only if you 
are certain that no errors will be encountered during program 
execution. 


T Specify tablename 


Use this option to change the tablename of the ORACLE table 
created by the .SQL file. The tablename must directly follow the T 
(with no intervening spaces). 


N Specify named range to translate 


If you want to identify a specific named range to be loaded, you 
can enter it here immediately following the N. If your entry does 
not correspond to a range in the Lotus file and there is more than 
one range, the program lists the ranges and prompts for your 
choice. You can also wait for the prompt in order to identify the 
range. 


L List named ranges in .RNG file 


If this option is entered, 123PREP writes all the named ranges in 
the Lotus 1-2-3 file to a file with the same filename as the Lotus file 
and an extension of .RNG. The option is useful if you want to 
examine the ranges in detail. 


If you omit the 1-2-3 filename extension from the filename 
specification, 123PREP displays the following question: 


Release 1 (.WKS file) Release 2 (.WK1 file) 
Which release of Lotus (1) or (2)? 


Type the appropriate number (1 or 2) and then press [Enter]. 
123PREP appends the appropriate extension to the filename you typed. 


If more than one range can be loaded in the specified spreadsheet file, 
123PREP displays information such as: 


Ranges defined in EMP.WKl: 
MAIN: [col=0..32, row=0..16] 


(BONUS): [col=17..32, row=14..16] 
(IGNORE): [col=10..10, row=7..7] 
(RANGE1): [col=0..7, row=0..5] 


(RANGE2): [col=9..16, row=0..5] 
Translate which range? 
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Examples of 123PREP 
Command-Line 
Arguments 


Example 1 


You can load any of the four named ranges (BONUS, IGNORE, 
RANGEI, or RANGB?) or the default range of the entire spreadsheet 
(123PREP calls this range MAIN). Type in the name of the range you 
wish to load and press [Enter]. Make sure that the range you select is 
in database form. 


Note: Ifyou are translating ranges, 123PREP assigns a table name that 
corresponds to the 1-2-3 filename, not to the name of the range that you 
selected. If SQL*Plus cannot accept the name that 123PREP assigned 
the table (such as your filename), it displays an error message. You can 
then edit the SQL and .CTL files to give the table a new name, or you 
may rename the 1-2-3 spreadsheet file and run 123PREP again. Check 
your SQL Language Reference Manual for restrictions on ORACLE table 


names. 


This section provides examples of using 123PREP with different 
optional parameters. 


To load the data from a 1-2-3 file named EMP.WK1 into your ORACLE 
database, invoke 123PREP in its simplest form by typing: 


C> 123PREP EMP 


Note: Be sure that ORACLE Database is loaded into memory before 
running this utility. 


123PREP prompts you for the release of 1-2-3 that you used to create 
the file. Because you used Release 2 (the filename extension is .WK1), 
type 2 and press [Enter]. 123PREP creates the files, EMP.SQL and 
EMP.CTL, based on the data contained in the original spreadsheet file. 
Because you did not type your ORACLE user account information 
(username / password) on the command line, 123PREP did not call 
SQL*Plus and SQL*Loader. 


To create the table and load the data that was originally contained in 
EMP.WKI file into the ORACLE database, type: 


C> SQLPLUS SCOTT/TIGER @EMP.SOL 
C> SQLLOAD SCOTT/TIGER EMP.CTL 


Consult your SQL*Plus User's Guide and ORACLE RDBMS Utilities 
User's Guide for information about using these two programs. 
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Example 2 To call SOL*Plus and SQL*Loader at the same time you translate the 
1-2-3 file, type your username and password with the 123PREP 
command: 


C> 123PREP SCOTT/TIGER EMP 
After you type this command, you are asked to specify which release of 
Lotus 1-2-3 you are using. 123PREP translates the file, creates a table 


named EMP in SQL*Plus, and loads the data into the table with 
SQL*Loader. 


Example3 The -D parameter allows you to delete any existing table that has the 
same name as your 1-2-3 file. 


C> 123PREP -DR SCOTT/TIGER EMP.WKS 


This example tells 123PREP to translate the Lotus 1-2-3 Release 1 file 
called EMP.WKS, and performs the following: 


+ The -D parameter tells 123PREP to delete the table named EMP 
if it exists. 


e The utility then creates a new table named EMP and loads the 
data into the new table. 

+ The -R parameter tells 123PREP to remove all files that were 
created during this process. 


Example4 The following command tells 123PREP to translate the file EMP.WK1 
into the files EMP.SQL and EMP.CTL. You may review or edit these 
two files. 


C> 123PREP EMP.WK1 


After invoking this command, you can load the data into the database 
by executing the following commands: 


C> SQLPLUS SCOTT/TIGER @EMP.SQL 
C> SOLLOAD SCOTT/TIGER EMP.CTL 


Example5 This command displays an error because the -C and -D parameters 
cannot be used together: 


C> 123PREP -CD EMP.WK1 
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Using SOL*Loader with ASCII Files 


Guidelines for File 
Translation 


SQL*Loader can prepare any delimited ASCII file for loading into an 
ORACLE database with the aid of a special utility program, ASCPREP. 
When run against an ASCII file, ASCPREP creates a .CTL command file 
that interprets the data, and invokes SQL*Loader to load it. Unlike 
DB3PREP and 123PREP, ASCPREP does not create a .SQL file with the 
table definition. You must create the table yourself before the load or 
direct the load into an existing table. 


ASCPREP does not actually translate the ASCII file data as it creates the 
control file. It checks the number of columns and delimiter character, and 
looks for the presence of dates. The program obtains the column headings 
from the ORACLE table into which the data will be loaded. The utility's 
flexibility can work to your advantage, since you may load a wide variety 
of records, including text, if they meet the basic conditions below: 


e The file must have delimiters. Any delimited ASCII file can be 
loaded. 

e The delimiter must be consistent; for example, you might 
always use a comma or semicolon. ASCPREP recognizes a 
newline mark in addition to the delimiter. 

e Columns must be no more than 255 characters. 

e You may have up to 256 fields in a record. Record length is 
limited only to the maximum number of fields times the 
maximum column width. 

e ORACLE reserved words cannot be used as field names (refer 
to the SQL Language Reference Manual and Appendix D of the 
ORACLE RDBMS Utilities User's Guide for further information 
about reserved words). 

e To preserve words or phrases containing the delimiter 
character or spaces as they are, put quotation marks around 
them (for example, you might want the following ina NAME 
column: “Smith, Howard”). ASCPREP will always optionally 
look for values enclosed in quotation marks. 

e To load a text file, create a table with one column of type CHAR 
and encase the entire text in quotation marks. Each line will be 
one record. 

+ ASCPREP converts any dates in the ASCII file into standard 
ORACLE date format (DD-MON-YY) after you have defined 
them to the program. 
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ASCPREP Help 


FIGURE 11-1 
ASCPREP Help Screen 


Sample ASCPREP 
Input and Output 


Sample ASCII File 


ASCPREP Command 


ASCPREP produces a screen listing the basic ASCPREP command 
syntax and options. To see the information, enter ascprep on the 
command line. The following help text will appear: 








ASCPREP: Version 1.0.27.0.2 - Production on Mon Mar 04 11:14:17 
1992 


Copyright (c) Oracle Corporation 1979, 1989. All rights reserved. 


ASCPREP prepares an Ascii file by creating a .CTL file for loading 
into the ORACLE database. The table must already exist before the 
Ascii file can be loaded. 


usage: ASCPREP [-options...] userid filename 


‘userid’ is your ORACLE username/password. 
‘filename’ is the name of the Ascii file to load. 
Valid options: 


c -- skip creation of and .CTL files (no translate) 

d -- delete table if it exists (default is to append data to 
table) 

r -- remove .CTL, .LOG, and .BAD files for ‘filename’ 

t -- specify table name (immediately following the letter t) 

P -- specify delimiter character (specify decimal ascii code, 
default is ,) 

l -- do not invoke SQL*Loader 





In order to give you a sense of how ASCPREP operates on an ASCII 
file, this section provides a sample input file, command, and control file. 


An ASCII file may have almost any format. Here is a sample file, 
DEPT.DAT: 


10; "ACCOUNTING" ; "NEW YORK" 
20; "RESEARCH" ; "DALLAS" 

30; "SALES" ; "CHICAGO" 

40; "OPERATIONS"; "BOSTON" 


The file above might be loaded into a table, OFFICES, with the 
following command string: 


ASCPREP -D -Toffices -P59 scott/tiger dept.dat 
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This command includes options to change the ORACLE table name, to 
identify the delimiter (;) and to replace data that may already be in the 
table. After the ASCPREP command has been entered, messages like 
the following appear: 


ASCPREP: Version 1.0.27.0.2 - Production on Mon Mar 04 11:14:17 
1992 


Copyright (c) Oracle Corporation 1979, 1989. All rights reserved. 


If ASCPREP finds a date column, it prompts for the date format. Then 
the program continues with: 


SQL*Loader: Version 1.0.27.0.2 - Production on Mon Mar 04 
11:13:59 1992 


Copyright (c) Oracle Corporation 1979, 1989. All rights reserved. 
Usage: SQLLOAD keyword=value [,keyword=value,...] 


Valid Keywords: 


userid -- ORACLE username/password 
control -- Control file name 
log -- Log file name 
bad -- Bad file name 
data -- Data file name 
discard -- Discard file name 
discardmax -- Number of discards to allow (Default all) 
skip -- Number of logical records to skip (Default 0) 
load -- Number of logical records to load (Default all) 
errors -- Number of errors to allow (Default 50) 
rows -- Number of rows in bind array (Default 64) 
bindsize -- Size of bind array in bytes (Default 64000) 
silent -- Suppress messages during run (header, feedback, 


errors, discards) 
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Sample .CTL File 


Running ASCPREP 


The control file generated by ASCPREP contains the LOAD DATA 
statement, name of the ASCII file and the ORACLE table, delimiter 
information, and a list of columns derived from the ORACLE table. 
The control file for DEPT.DAT would resemble the following: 
LOAD DATA 
INFILE “DEPT.DAT” 
REPLACE 
INTO TABLE OFFICES 
FIELDS TERMINATED BY ';’ OPTIONALLY ENCLOSED BY '"* 
(OFFICENO, 
NAME, 
SIPY) 


Note that the control file identifies both the delimiter and possible 
quotation marks around each field value. All ASCPREP control files 
have this statement, since ASCII files frequently contain quotation 
marks. 


Executing ASCPREP is simple. The general syntax of the command is 
as follows: 


ASCPREP [-options] username/password filename.ext 
Options represent one or more ASCPREP options. 
Username/password is your ORACLE account and password. 


Filename.extis the name and extension of the ASCII file. The extension 
is required. 


ASCPREP options are explained in “ASCPREP Options” later in this 
chapter. If the file’s delimiter character is not a comma, you must 
specify it with the -P option. 


ASCPREP will assume that the ORACLE table has the same name as 
the ASCII file unless you enter an option to identify a different table. 
Loaded data will be appended to existing rows unless you enter an 
option to replace existing data. 


The following is an example of a simple ASCPREP load without 
options: 


ASCPREP scott/tiger sales.asc 
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Specifying Dates 


The program checks the table to see if there are any date columns. If 
there are, ASCPREP lists the matching date fields from the ASCII file 
and prompts you for the correct format: 


Enter format for DATE column columnname (for example, DD-MON-YY) : 


The default value shown (DD-MON-YY) is the standard ORACLE date 
format. If the dates listed from the file have the same format as the 
default, press [Enter]. If the dates have a different format, enter the 
exact format according to the following conventions and press [Enter]: 


e Use pp for day of month. 


e Use mm for numeric month (for example, “02”), mon for first 
three letters of month’s name (for example, “Feb”), and month 
for the full spelling (for example, “February”). ASCPREP is 
case-sensitive; you may specify capital first letter, all capitals, 
or lower case by the way you enter month. 


+ Enter vy or yyyy for year format. 


e Enter the day, month and year in the order in which they 
appear in the listed dates. 


+ Use the separator characters from the ASCII file; for example, 
use a slash (/) or hyphen (>). (Refer to the SQL*Plus User's 
Guide and Reference for a complete list of date formatting 
conventions.) 


For example, ASCPREP might list: 


Dates for column HIREDATE 

12/17/1980 

02/20/1980 

02/22/1981 

04/02/1981 
Enter format for DATE column HIREDATE (for example, DD-MON-YY) : 
mm/dd/yyyy 


In this case, you would enter mm/dd/yyyy to describe the listed dates. 
ASCPREP will then translate and load the file. 
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ASCPREP Options ASCPREP options allow you to modify conditions of the load. In some 
cases, an option must be entered; for example, when the delimiter 
character for the file is different from the default or when the ORACLE 
table for the data has a different name. 


You may specify one or more options. Options are prefixed by a 
hyphen (-). You may enter the options in a string with no spaces 
between them, or separate options with a space. Options separated by 
spaces must have a hyphen before each new option string (for 
example, -D -Tnovproj). 


When an option calls for a table name or filename, do not use a space to 
separate the option letter from the table name or filename. 


Options are like toggle switches; once an option has been entered, 
repeating it will turn the option off. A third entry turns it back on. Do 
not correct errors by re-entering an option or you will turn the option 
off. 


ASCPREP options consist of the following: 
C Skip creation of .CTL file 


When you enter this option, ASCPREP will not create the .CTL file; 
it will simply call SQL*Loader to execute the filename entered. The 
«CTE file must already exist. You use this option when you want to 
reload a corrected .CTL file (refer to the following section, “Editing 
the .CTL File”). 


D Delete table if it exists 


This option will replace any existing data in the table with the 
loaded data. If the table is empty, it will not be deleted. 


R Remove .CTL, .LOG, and .BAD files 


If you want ASCPREP to delete the .CTL, log, and bad files 
immediately after the load, enter this option. You should exercise 
caution when using this option because if the load contains errors 
there would be no record of the error messages or dropped records. 


T Specify table name 


Enter this option immediately followed by the tablename (no 
spaces between) if you want to change the name of the destination 
table in ORACLE. 
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P Specify delimiter character 


ASCPREP assumes that the delimiter character is a comma (,). If 
another character is used, enter it here so the program will 
recognize it. You must use decimal ASCII code (see “Notes” later in 
this section). 


L Do not invoke SQL*Loader 


Use this option when you want to examine and/or edit the .CTL 
file before loading. (Refer to “Editing the .CTL File” for the kinds 
of edits you may make.) To load the file, you can enter the 
ASCPREP command again with the -C option, or run SQL*Loader 
with the file. 


Notes: 


+ If the delimiter for your file is a comma, you do not need to 
enter a delimiter; if it is anything else, you must specify it for 
the program to work properly. An ASCII character codes list 
can be found in most technical reference manuals. Here are the 
most common characters with their decimal code equivalents: 





Character Name Decimal Code 

P comma 44 

- hyphen 45 

: period 46 

ji slash 47 

ý colon 58 

z semicolon 59 

\ backslash 92 
underscore 95 


+ Never use spaces as a delimiter. Spaces are ignored in the 
ASCII file except when enclosed in quotes. 

* If you choose to run SQL*Loader with the .CTL file, you may 
use the SQL*Loader options; for example, request the program 
to change the BAD and .LOG filenames. Refer to the ORACLE 
RDBMS Utilities User’s Guide for information about the 
SQL*Loader options and command syntax. 
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Editing the .CTL File Your usual reason for editing the control file will be to make the 
contents of the ASCII file correspond to columns in an ORACLE table. 
Each field name listed in the .CTL file created by ASCPREP 
corresponds to one column from the table. The first field from the 
ASCII file will be loaded into the first column name in the .CTL file, 
and so forth. If you are not certain that the data from the ASCII file is 
matched to the correct table columns, check the columns in the 
ORACLE table with the DESC command. Then edit the .CTL file to 
inspect the column listing, and finally (if necessary) look at the ASCII 
file. 


The crucial match must be between the order of names as listed in the 
‘CTL file and the order of fields from the ASCII file. The names in the 
-CTL file do not have to be in the same order as the actual table 
columns; SQL*Loader will look for the matching column anywhere 
among the table’s column names. 


Example In this example the user manipulates ASCPREP to load an ASCII file 
into ORACLE. It will show you in more detail the relationship 
between the ASCII file and the ORACLE table. 


ROBERT has an ASCII file with information about his friends that he 
wants to load into ORACLE. The ASCII file, NAMES.TXT, contains 
each person's age, name, date of birth, and weight as follows: 

18; “Julie”; 09/09/1970; 110 

22; "Richard"; 09/05/1966; 180 

28; “Bill”; 01/03/1961; 150 

24; "Carol"; 07/14/1965; 110 

22; "Terry"; 12/15/1966; 165 


ROBERT already has an ORACLE table, FRIENDS, with this 
information. The problem is that his existing table is not in the same 
order. Its columns are: 





(name char (30) 
age number, 
weight number, 
birthdate date) 


Using ASCPREP options, ROBERT can create a control file for this 
table, edit it, and then load the corrected control file. First he invokes 
ASCPREP as follows: 


ASCPREP -L -P59 -Tfriends robert/swordfish names.txt 


Notice that he has used the -L option to avoid loading at present, the -P 
option to identify the semicolon delimiter, and he has identified the 
tablename as friends. 





11-20 ORACLE Database Installation and User’s Guide 














ASCPREP finds a date column, BIRTHDATE, in the table FRIENDS, 
and matches it to the last field of each record in the ASCII file because 
both are in the same position. ROBERT will see on his screen: 


Dates for column BIRTHDATE: 
110 
180 
150 
110 
165 
Enter format for DATE column BIRTHDATE (default is DD-MON-YY): 


The program is listing the weight values, not the birthdate. Since the 
incorrect match cannot be corrected at this prompt, ROBERT presses 
[Return] to accept the default. 


The control file, NAMES.CTL, looks like the following: 


LOAD DATA 

INFILE “NAMES.TXT" 

APPEND 

INTO TABLE “FRIENDS” 

FIELDS TERMINATED BY ';', OPTIONALLY ENCLOSED BY '"” 
(NAME, 

AGE, 

WEIGHT, 

BIRTHDATE DATE) 


ROBERT edits the control file to change the order of column names in 
the .CTL file so they match the ASCII data. Since he did not enter the 
correct date format at the ASCPREP prompt, he enters it here after the 
DATE specification. (It is necessary to identify the date format so that 
ORACLE can convert the dates into standard ORACLE format.) The 
modified control file will look like the following: 


LOAD DATA 

INFILE “NAMES.TXT” 

APPEND 

INTO TABLE “FRIENDS” 

FIELDS TERMINATED BY ';', OPTIONALLY ENCLOSED BY '"' 
(AGE, 

NAME, 

BIRTHDATE DATE 'MM/DD/YYYY‘, 

WEIGHT) 
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Now ROBERT invokes ASCPREP again with the -C option to load the 
corrected control file. He does not need to specify the tablename again: 


ASCPREP -C robert/swordfish names.txt 
His data will appear in the correct columns in his ORACLE table. Refer 


to Chapter 9, “Control File Syntax,” for more information about syntax 
and options for the control file. 


This section contains several additional samples of ASCPREP options. 


User LINDA is loading a file from a directory on a diskette: 
ASCPREP linda/medusa a:\load\ascdata.asc 


The program will check that the file ASCDATA.ASC is in the drive and 
directory; it will expect LINDA to own the table ASCDATA. 


User SCOTT has renamed the table for the ASCII data: 

ASCPREP -Tdept scott/tiger deptlst.asc 

This is an example of combined options. User LINDA is loading a file 
with a different delimiter character, /, and so she enters the -P option 
with decimal code 47. She is also renaming the table, and is so 


confident of the result that she has directed ASCPREP to delete all files 
(CTL, .LOG, and .BAD) with the original filename after the load: 


ASCPREP -RP47 -Tassets linda/medusa debits.asc 


User SYSTEM performs the load in two steps. SYSTEM directs 
ASCPREP not to call SQL*Loader with the first pass. The control file 
can then be examined or edited before loading. The example shows 
two ways of performing the actual load: with ASCPREP and 
SQL*Loader. 


ASCPREP -L system/vampire personal.asc 


The command above creates the control file PERSONAL.CTL. When 
ready to load, SYSTEM enters the following command to use ASCPREP: 


ASCPREP -C system/vampire personal.ctl 
Or the file may be loaded with SQL*Loader as follows: 


SOLLOAD system/vampire personal.ctl 
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APPENDIX 


UNIQUE DOS AND 
OS/2 LIMITATIONS 


his appendix describes limitations that apply to ORACLE Database 
for DOS and OS/2. 
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DOS Limitations 


Maximum Opened 
Files 


Maximum Partition 


Sizes 


Certain versions of DOS can limit the performance of the ORACLE 
Database. The following sections outline those restrictions. 


ORACLE Database for DOS can open the lesser of 250 disk files, or 5 
files less than the value of the FILES parameter in CONFIG.SYS. If you 
are using MS-DOS Version 4.0 or later and you receive the message, 
“System Resources Exhausted,” the problem is likely caused by the 
SHARE utility. If SHARE.EXE is loaded and you are using MS-DOS, 
use the /F: switch in order to increase the number of files that SHARE 
can handle. If you are using DR DOS and SHARE.EXE is loaded, use 
the /L: switch to increase this value. See your DOS documentation for 
more information about the SHARE utility. 


Versions of MS-DOS prior to Version 4.0 do not permit hard-disk 
partitions greater than 32 megabytes in size. Despite this limitation, 
certain hard-disk drive manufacturers supply software drivers that 
create partitions greater than 32 megabytes. 


Many users have reported problems when using ORACLE with these 
drivers, even with databases smaller than 32 megabytes. Since you 
cannot predict which drivers will cause these problems, and you 
cannot avoid the problems when they occur, you should keep 
partitions within the 32-megabyte limit. 


Note: COMPAQ MS-DOS Version 3.31 and higher, all MS-DOS 
Versions 4.0 and higher, and DR DOS do not have this limitation. 
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ORACLE Limitations Under DOS 


Manual and Automatic 
Archiving 


Trace and Alert Files 


SQL Trace Limitations 


TKPROF Limitations 


Multiple (Nested) 
Logons 


The following sections outline limitations specific to ORACLE Database 
for DOS. 


ORACLE Database for DOS does not support the manual archiving of 
redo log files. ORACLE does support automatic archiving; however, the 
procedures for enabling and disabling automatic archiving differ from 
those discussed in the ORACLE RDBMS Database Administrator's Guide. If 
you wish to enable automatic archiving with ORACLE Database for DOS, 
follow the instructions in Chapter 7 of this Guide. 


If the parameters BACKGROUND_DUMP_DEST and 
USER_DUMP_DEST are not set in INIT.ORA, no trace or alert files are 
generated. If the parameters are set (to a valid directory name), one 
trace file is generated per logon and one alert file is generated each time 
you start up a database. For more information on trace and alert files, 
see the ORACLE RDBMS Database Administrator's Guide. 


If you set the INIT.ORA parameter TIMED_STATISTICS to true to 
determine elapsed time for SQL statements, the SQL trace facility will 
always generate a value of zero (0) for the CPU-Time field. Use the 
ELAPSED_TIME field to determine an approximate answer. 


The DOS version of the TKPROF utility can print statistics for a 
maximum of 600 SQL statements. If you set the INIT.ORA parameter 
TIMED_STATISTICS equal to TRUE to determine CPU time, TKPROF 
will return a value of zero (0); no calls are made to DOS to determine 
elapsed CPU time. Refer to the ORACLE RDBMS Performance Tuning 
Guide for more information on using the TKPROF utility. 


ORACLE Database for DOS is a single-process database. Because of 
this fact, you should not attempt multiple, concurrent logons to the 
database. If you create a second logon while a previous logon contains 
uncommitted database transactions, you will receive an ORACLE error 
message. This is most likely to happen if you use the HOST command 
in an ORACLE tool (such as SOL*DBA) to start a second ORACLE tool. 
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MAXDATA Limit You can set the MAXDATA parameter during SOL*DBA and SQL*Plus 
sessions. MAXDATA limits the maximum amount of data that can be 
retrieved in a single fetch during a SELECT statement. 


MAXDATA cannot be larger than 32K under DOS. This permits an 
array with an average size of 10 rows by 40 columns. This limitation 
applies only to SQL*Plus. 


l SQL*DBA Commands To pass a COMMAND: string that includes spaces or an equal sign to 
SQL*DBA, include double quotation marks (backslash double quote, 
\") before and after the actual command to be executed. For example: 


command=\"startup pfile=MYINIT.ORA\" 
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EPA ANA 
ORACLE Limitation under OS/2 


SQL Trace Limitations 


If you set the INIT.ORA parameter TIMED_STATISTICS to true to 
determine elapsed time for SQL statements, the SQL trace facility will 
always generate a value of zero (0) for the CPU-Time field. Use the 
ELAPSED_TIME field to obtain an approximate answer. 
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APPENDIX 


ORACLE DATABASE 
ERROR MESSAGES 
AND CODES 


his appendix lists error messages and codes specific to ORACLE 

Database for DOS and ORACLE Database for OS/2. It also lists 
possible causes for the error messages and suggests corrective actions. 
The information in this appendix does not duplicate information in the 
Version 6.0 ORACLE RDBMS Error Messages and Codes Manual. 
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Codes 9200-9299: DOS and OS/2 Database Errors 


ORA-00299: 


ORA-09201: 


ORA-09202: 


ORA-09203: 


ORA-09204: 


ORA-09205: 


ORA-09206: 


ORA-09207: 


ORA-09208: 


ORA-09210: 


ORA-09211: 


ORA-09212: 


ORA-09213: 


ORA-09214: 


ORA-09215: 


The messages below are always followed by an OSD (operating-system- 
dependent) error message specifying how the error was treated by DOS or 
OS/2. When you receive one of these messages, look up the OSD 
message number in the following section for an explanation of the error. 


ARCHIVE LOG STOP not applicable for single-process database 
sclgt: error getting or testing latch 

sltIn: error translating logical name 

slspool: error spooling file to printer 

slemop: error opening error message file 

slemcl: error closing error message file 

slemcr: error creating error message file 

slemrd: error reading error message file 

slemcw: error writing to error message file 
slsleep: error temporarily suspending process 
slsprom: error prompting user 

slbtpd: error converting ASCII to packed decimal 
slpdtb: error converting packed decimal to ASCII 
smscre: error creating SGA 


smsget: error attaching to SGA 
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ORA-09216: 


ORA-09217: 


ORA-09218: 


ORA-09219: 


ORA-09220: 


ORA-09221: 


ORA-09222: 


ORA-09224: 


ORA-09225: 


ORA-09228: 


ORA-09229: 


ORA-09230: 


ORA-09231: 


ORA-09233: 


ORA-09234: 


ORA-09235: 


ORA-09236: 


ORA-09237: 


smpall: error allocating memory for PGA 

smcacx: error allocating memory for context area 
spini: error initializing process 

spdcr: error creating detached (background) process 
spdde: error terminating detached (background) process 
sptpa: error flagging process 

spwat: error temporarily suspending process 

sfccf: error creating file 

sfifi: error identifying file 

sfofi: error opening file 

sfrfb: error reading from file 

sfsrd: error reading from file 

sfwfb: error writing to file 

sftopn: error opening file 

sftget: error reading from file 

sftcls: error closing file 

sfcopy: error copying file 


sigpidu: error obtaining process id 
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ORA-09238: 


ORA-09239: 


ORA-09240: 


ORA-09241: 


ORA-09242: 


ORA-09243: 


ORA-09244: 


ORA-09245: 


ORA-09246: 


slgfn: error fabricating file name 

smmmsadd: internal error reserving memory block 
soarch: error archiving file 

ss_tln: error translating logical name 

sql2tt: two-task error translating 

splon: error working with user name 

spdba: error verifying authorization 

sllfop: error opening file 


smmmsget: internal error reserving memory block 
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Codes 0000-0999: OS/2-Specific Error Messages 


0S/2 


OSD-00001: 


Cause: 


Action: 


OSD-00002: 


Cause: 


Action: 


OSD-00003: 


Cause: 


Action: 


OSD-00004: 


Cause: 


Action: 


OSD-00005: 


Cause: 


Action: 


This section lists and explains the error codes you might receive when 
running ORACLE Database for OS/2. The messages are usually prefixed 
by an ORACLE message in the 9200-9299 range. 

unable to suspend thread using DosSleep() 

There was an unexpected return from OS/2 system service DosSleep(). 
Check the operating-system error code and consult your OS/2 
documentation. 

resultant translation too big 

The final translation of the CONFIG variable is too large to process. 


Use smaller CONFIG variable values. 


input variable too large to process 
The CONFIG variable name is too long to process. 


Use smaller names for CONFIG variables. 


variable value too long in environment 


The CONFIG variable value contained in the environment is too large to 
process. 


Use a smaller CONFIG variable value in the environment. 


variable value too long in CONFIG_FILE 


The CONFIG variable value contained in the CONFIG file is too large to 
process. 


Use a smaller CONFIG variable value in the CONFIG file. 
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OSD-00006: 


Cause: 


Action: 


OSD-00007: 


Cause: 


Action: 


OSD-00008: 


Cause: 


Action: 


OSD-00009: 


Cause: 


Action: 


OSD-00010: 


Cause: 


Action: 


text contains no translatable elements 
No recognized variables are contained in the text to be translated. 


Check and, if necessary, correct the text to be translated. 


config variable ORACLE_SPOOLER undefined 
The CONFIG variable ORACLE_SPOOLER could not be translated. 


Properly define ORACLE_SPOOLER and try again. 


unable to execute OS spooling command 


The operating-system spooling command, defined by the CONFIG 
variable ORACLE_SPOOLER, could not be executed. 


Properly define ORACLE_SPOOLER and try again. 


unable to open file 


An invalid path or filename was specified, the device is full, or there are 
insufficient file handles. 


Make sure that the file exists and /or the device is not full, and verify that 
the operating system is functioning correctly. If the error message 
persists, call Oracle Customer Support. 

unable to close file 


The media has been damaged. 


Recover the file if necessary, and verify that the operating system is 
functioning correctly. 


ORACLE Database Installation and User's Guide 























F 


OSD-00011: 
Cause: 


Action: 


OSD-00012: 


Cause: 


Action: 


OSD-00013: 


Cause: 


Action: 


OSD-00014: 


Cause: 


Action: 


OSD-00015: 


Cause: 


Action: 


OSD-00016: 


Cause: 


Action: 


unable to create file 

An invalid path or filename was specified, or the device is full. 
Verify that the path exists, that the device is not full, and/or that the 
operating system is functioning properly. 

seek failure 

The media is damaged. 


Recover the file if necessary, and verify that the operating system is 
functioning correctly. 


read failure 

The media is damaged. 

Recover the file if necessary, and verify that the operating system is 
functioning correctly. 

truncated read 

There was an unexpected end of file caused by damaged media. 


Verify that the file is not damaged. 


seek failure 
The media is damaged. 


Recover the file if necessary, and verify that the operating system is 
functioning correctly. 


write failure 
The device is full or the media is damaged. 


Verify that the device is not full and the file not damaged. 
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OSD-00017: 


Cause: 


Action: 


OSD-00020: 


Cause: 


Action: 


OSD-00021: 


Cause: 


Action: 


OSD-00022: 


Cause: 


Action: 


OSD-00023: 
Cause: 


Action: 


OSD-00024: 
Cause: 


Action: 


truncated write 


The system is unable to write to the device, either because it is full or 
because the media is damaged. 


Verify that the device is not full and the file is not damaged. 


stdin not responding 
The system is unable to receive input from the standard input stream. 


Verify that the process has access to an input device. 


invalid number 
You entered an invalid ASCII number. 


Use a valid representation of the number. 


invalid exponent 
You entered an invalid exponent on an ASCII number. 


Use a valid representation of the number. 


internal overflow while converting to packed decimal 
This is an internal error. 


Contact Oracle Customer Support. 


invalid packed decimal number 
You entered an invalid packed decimal number. 


Use a valid representation of the number. 
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OSD-00025: 


Cause: 


Action: 


OSD-00026: 
Cause: 


Action: 


OSD-00028: 
Cause: 


Action: 


OSD-00029: 
Cause: 


Action: 


OSD-00031: 


Cause: 


Action: 


OSD-00032: 


Cause: 


Action: 


internal overflow while converting to ASCII 
This is an internal error. 


Contact Oracle Customer Support. 


too many database buffers specified 
The INIT.ORA parameter 'DB_BLOCK_BUFFERS is too large. 


Decrease the value of 'DB_BLOCK_BUFFERS/ and retry the operation. 


cannot allocate variable part of SGA 

The program is out of memory. 

Use the OS/2 memory manager. Shut down all unnecessary processes or 
install more memory in the machine. 

cannot allocate space for database buffers 

The program is out of memory. 


Use the OS/2 memory manager. Shut down all unnecessary processes or 
install more memory in machine. 


unable to attach to variable part of SGA 


The shared memory containing the variable part of the SGA is not 
available. 


Verify that the SGA has been created properly. 


unable to attach to database buffers area of SGA 
The shared memory containing the database buffers is not available. 


Verify that the SGA has been created properly. 
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OSD-00033: 


Cause: 


Action: 


OSD-00034: 
Cause: 


Action: 


OSD-00035: 


Cause: 


Action: 


OSD-00037: 


Cause: 


Action: 


OSD-00038: 


Cause: 


Action: 


unable to attach to redo buffer area of SGA 
The shared memory containing the redo buffers is not available. 


Verify that the SGA has been created properly. 


unable to allocate variable portion of PGA 

The program is out of memory. 

Use the OS/2 memory manager. Shut down all unnecessary processes or 
install more memory in the machine. 

unable to allocate memory for context area 

The program is out of memory. 

Use the OS/2 memory manager. Shut down all unnecessary processes or 
install more memory in the machine. 

DosExecPgm() failure, unable to spawn process 


There was an unexpected return from the OS/2 system service, 
DosExecPgm(). 


Check your operating-system error code and consult the OS/2 
documentation. 


invalid pid 


The process ID is not recognized by the system, and the process was 
terminated. 


This is an internal error. Contact your DBA. 
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OSD-00039: 


Cause: 


Action: 


OSD-00040: 


Cause: 


Action: 





Action: 


OSD-00041: 


Cause: 


Action: 


OSD-00043: 


Cause: 


Action: 


OSD-00044: 


Cause: 


DosKillProcess() failure, unable to kill process 


There was an unexpected return from the OS/2 system service, 
DosKillProcess(). 


Check your operating-system error code and consult the OS/2 
documentation. 
DosFlagProcess() failure, unable to signal process 


There was an unexpected return from the OS/2 system service, 
DosFlagProcess(). 


Check the operating-system error code and consult the OS/2 
documentation. 


DosSemSetWait() failure, unable to acquire semaphore 


There was an unexpected return from the OS/2 system service, 
DosSemSetWait(). 


Check the operating-system error code and consult the OS/2 
documentation. 


unable to create or open file 
The device is full or the path does not exist. 


Verify that the device is not full and check whether the path exists. 


<create> option specified, file already exists 
You have specified an already existing file in the CREATE statement. 


Delete the file or use the <reuse> option. 


ORACLE Database Error Messages and Codes 





B-11 




















B-12 


OSD-00049: 


Cause: 


Action: 


OSD-00051: 


Cause: 


Action: 


OSD-00052: 


Cause: 


Action: 


OSD-00053: 


Cause: 


Action: 


OSD-00055: 


Cause: 


Action: 


OSD-00056: 


Cause: 


Action: 


illegal option specified 
This is an internal error. 


Contact Oracle Customer Support. 


unable to write to file, device full 
The device is full. 


Free up some space on the device. 


unsupported logical block size 
Either the logical block size is not a multiple of 512 bytes or it is too large. 


Change the requested logical block size. 


unable to allocate memory 
The program is out of memory. 


Use the OS/2 memory manager. Shut down all unnecessary processes or 
install more memory in the machine. 


unable to open file for reuse 
The specified file does not exist. 


Use the <create> option to create the file. 


unable to seek to beginning of file 
The media has been damaged. 


Recover the file if necessary, and verify that the operating system is 
functioning correctly. 
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OSD-00057: 


Cause: 


Action: 


OSD-00059: 
Cause: 


Action: 


OSD-00061: 


Cause: 


Action: 


OSD-00062: 


Cause: 


Action: 


OSD-00063: 
Cause: 


Action: 


OSD-00066: 


Cause: 


Action: 


unable to read file header block 
The media is damaged. 


Recover the file if necessary, and verify that the operating system is 
functioning correctly. 


unable to write to file 
The device is full or the media has been damaged. 


Verify that the device has free space and that the file is not damaged. 


invalid file header 
The file is corrupted. 


Recover the file. 


file size mismatch 
The file to be reused is either too large or too small. 


Specify the correct file size or delete it and use the <create> option. 


logical block size mismatch 
A file was created with a logical block size different from that requested. 


Use matching logical block sizes. 


DosChgFilePtr() failure, unable to read from file 


There was an unexpected return from the OS/2 system service, 
DosChgFilePtr(). 


Check the operating-system error code and consult your OS/2 
documentation. 
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OSD-00067: 


Cause: 


Action: 


OSD-00068: 


Cause: 


Action: 


OSD-00069: 


Cause: 


Action: 


OSD-00070: 


Cause: 


Action: 


OSD-00071: 


Cause: 


Action: 


DosRead() failure, unable to read from file 

There was an unexpected return from the OS/2 system service, DosRead(). 
Check the operating-system error code and consult the OS/2 
documentation. 

truncated read 


The system encountered an unexpected end-of-file, which may be due to 
damaged media. 


Verify that the file is not damaged. 


DosAllocSeg() failure, unable to allocate memory 
The program is out of memory. 


Use the OS/2 memory manager. Shut down all unnecessary processes or 
install more memory in the machine. 


DosFreeSeg() failure, unable to free allocated memory 


There was an unexpected return from the OS/2 system service, 
DosFreeSeg(). 


Check the operating-system error code and consult the OS/2 
documentation. 


DosWrite() failure, unable to write to file 


There was an unexpected return from the OS/2 system service, 
DosWrite(). 


Check the operating-system error code and consult the OS/2 
documentation. 
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OSD-00078: 


Cause: 


Action: 


OSD-00080: 
Cause: 


Action: 


OSD-00083: 
Cause: 


Action: 


OSD-00086: 


Cause: 


Action: 


OSD-00087: 


Cause: 


Action: 


OSD-00088: 
Cause: 


Action: 


filename too long 
The filename is too long. 


Use a shorter filename. 


unable to get string from file 
The file is corrupted. 


Recover the file, if necessary. 


logical block sizes different 
The source and destination files have different logical block sizes. 


Use files with the same logical block size. 


DosGetPid( failure, unable to obtain process id 


There was an unexpected return from the OS/2 system service, 
DosGetPid(. 


Check the operating-system error code and consult the OS/2 
documentation. 


resultant filename too large for buffer 
The full path and filename are too large. 


Use a smaller path / filename. 


internal buffer overflow 
This is an internal error. 


Contact Oracle Customer Support. 
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OSD-00089: 


Cause: 


Action: 


OSD-00090: 


Cause: 


Action: 


OSD-00091: 


Cause: 


Action: 


OSD-00094: 


Cause: 


Action: 


OSD-00098: 


Cause: 


Action: 


OSD-00109: 


Cause: 


Action: 


unable to attach to SGA: SGA does not exist 
No SGA exists to which to connect. 


Start up an ORACLE instance. 


invalid logical block size 
The logical block size is not a multiple of 512 bytes, or it is too large. 


Change the requested logical block size. 


invalid block size requested 
The system is attempting to allocate zero memory; this is an internal error. 


Contact Oracle Customer Support. 


unable to find PID in semaphore array 
The System Global Area (SGA) is not valid. This is an internal error 


Contact Oracle Customer Support. 


unable to acquire internal semaphore for process 


Too many ORACLE processes are active, exceeding the maximum 
number of connections. 


Delete an unused connection, then try again. 


unable to allocate memory 
The program is out of memory. 


Use the OS/2 memory manager. Shut down unnecessary processes or 
install more memory in your machine. 
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OSD-00111: 


Cause: 


Action: 


OSD-00112: 


Cause: 


Action: 


OSD-00113: 


Cause: 


Action: 


OSD-00114: 


Cause: 


Action: 


OSD-00115: 


Cause: 


Action: 


OSD-00116: 


Cause: 


truncated write 


The system is unable to write to the device, either because the device is 
full or because the media is damaged. 


Verify that the device is not full, and that the file is not damaged. 


DosSetPrty() failure, unable to set process priority 


There was an unexpected return from the OS/2 system service, 
DosSetPrty(). 


Check the operating-system error code and consult the OS/2 
documentation. 

missing colon (:) in CONFIG parameter ORACLE_PRIORITY 
The ORACLE_PRIORITY string has an invalid format. 


Reformat the ORACLE_PRIORITY string and try again. 


invalid priority class in CONFIG parameter ORACLE_PRIORITY 
The specified priority class is out of the correct range. 


Specify a priority class between 1 and 3. 


invalid priority delta in CONFIG parameter ORACLE_PRIORITY 
The specified priority delta is out of the acceptable range. 


Specify a priority delta between 0 and 31. 


DosSemSet() failure, unable to set semaphore 


There was an unexpected return from the OS/2 system service, 
DosSemSet(). 


ORACLE Database Error Messages and Codes B- 





17 





























iL 


Action: 


OSD-00117: 


Cause: 


Action: 


OSD-00118: 


Cause: 


Action: 


OSD-00119: 


Cause: 


Action: 


OSD-00120: 


Cause: 


Action: 


Check the operating-system error code and consult the OS/2 
documentation. 


DosSemClear() failure, unable to release semaphore 


There was an unexpected return from the OS/2 system service, 
DosSemClear(). 


Check the operating-system error code and consult the OS/2 
documentation. 
DosSemWait() failure, unable to obtain semaphore 


There was an unexpected return from the OS/2 system service, 
DosSemWait(). 


Check the operating-system error code and consult your OS/2 
documentation. 


DosAllocHuge() failure, unable to allocate memory 


The program is out of memory. 


Use the OS/2 memory manager. Shut down unnecessary processes or 


install more memory in the machine. 


unable to attach to buffer header array in SGA 


The shared memory containing the database buffer headers is not 
available. 


Verify that the SGA has been created properly. 
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OSD-00122: 


Cause: 


Action: 


OSD-00123: 


Cause: 


Action: 


OSD-00124: 


Cause: 


Action: 


OSD-00125: 


Cause: 


Action: 


OSD-00126: 


Cause: 


Action: 


DosSetMaxFH() failure, unable to increase maximum file handles 
There is not enough memory or the request exceeds system limits. 
Use the OS/2 memory manager. Shut down unnecessary processes or 
install more memory in the machine. 

unable to read string from file 

Information could not be read from the file. 

Check the operating-system error code and consult the OS/2 
documentation. 

unable to spawn ORACLE_ARCH_COMMAND 


The command ORACLE_ARCH_COMMAND could not be found or 
executed. 


Verify that ORACLE_ARCH_COMMAND is in your path and that it is 
executable. 

user requested cancel of archiving operation 

The archiving program was canceled with [Ctrl]-C by the user. 


No action required. 


DosCwait failure, unable to obtain result archive results 


The OS/2 system service, DosCwait, was unable to return the results of 
the last archive job. The program assumes the archive was unsuccessful. 


Check the operating-system error code and consult your OS/2 
documentation. 
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OSD-00127: 


Cause: 


Action: 


OSD-00128: 


Cause: 


Action: 


OSD-00129: 


Cause: 


Action: 


OSD-00130: 


Cause: 


Action: 


OSD-00131: 


Cause: 


Action: 


OSD-00132: 


Cause: 


Action: 


ORACLE_ARCH_COMMAND process reported failure 
The ORACLE_ARCH_COMMAND process exited with a return code 


other than zero, indicating failure. This is probably due to errors in a 
user-written archiving routine. 


Verify that the archiving routine is correct and error-free. 


intermediate translation too big 
The value of a CONFIG variable was too big to use. 


Use smaller CONFIG variable values. 


file specified by CONFIG_FILES parameter missing 


One of the files specified by the CONFIG parameter, CONFIG_FILES, 
does not exist or cannot be accessed. 


Verify that all named CONFIG files exist and can be opened. Set 
MISSING_CONFIG_ERROR=FALSE to turn this error off. 


DosGetEnv failure, unable to locate environment 
This is an internal error. 


Contact Oracle Customer Support. 


internal buffer overflow 
This is an internal error. 


Contact Oracle Customer Support. 


SGA not yet valid, initialization in progress 
The program attempted to connect to ORACLE during initialization. 


Wait until the database has been initialized, then try again. 
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OSD-00133: default username too large 


Cause: The value assigned to the config variable, USERNAME, is too large to be 
used for default logins. 


Action: Redefine the USERNAME variable to a valid account name. 


OSD-00134: — self-referencing CONFIG parameter 
Cause: A config parameter is defined in terms of itself. 


Action: Redefine the config parameter to avoid ambiguity. 


OSD-00135: DosQFileInfo failure, unable to obtain file info 


Cause: There was an unexpected return from the OS/2 system service, 
DosQFileInfo(). 


Action: Check the operating-system error code and consult the OS/2 
documentation. 
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Codes 1000-1999: DOS-Specific Errors 


OSD-01000: 


Cause: 


Action: 


OSD-01008: 


Cause: 


Action: 


OSD-01009: 


Cause: 


Action: 


OSD-01030: 


Cause: 


Action: 


This section lists and explains the error codes you might receive when 
running ORACLE Database for DOS. The messages are usually prefixed 
by an ORACLE message in the 9200-9299 range. 


self-referencing CONFIG parameter 
A parameter in the CONFIG.ORA file is defined in terms of itself, as in the 
following example: ORACLE_HOME = %ORACLE_HOME%\HOME. 


Correct the CONFIG.ORA definition so that the parameter no longer 
refers to itself. 


file specified by CONFIG_FILES parameter missing 
A file specified by the CONFIG_FILES parameter is inaccessible. 


Make sure that each of the CONFIG.ORA files exists and can be opened. 
Alternatively, set the MISSING_CONFIG_ERROR variable to FALSE to 
turn this error message off. 


default username too large 
The value of the CONFIG.ORA variable USERNAME is too long to be 
used in a default login. 


Redefine the USERNAME variable to a valid account name of 26 
characters or less. Omit the “OPS$” string from the USERNAME value. 


unable to execute OS spooling command 


The OS spooling command defined by the CONFIG.ORA variable 
ORACLE _SPOOLER could not be executed. 


Redefine the ORACLE_SPOOLER variable. 
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OSD-01031: 


Cause: 


Action: 


OSD-01032: 


Cause: 


Action: 


OSD-01033: 


Cause: 


Action: 


OSD-01040: 


Cause: 


Action: 


OSD-01041: 


Cause: 


Action: 


stdin not responding 

An application did not receive enough input from the specified file. 
Modify the file to include the necessary information and restart the 
application. 

An attempt was made to spawn a background process 

This is an internal error, not normally expected to occur. 


Contact Oracle Customer Support. 


An attempt was made to kill a background process 
This is an internal error, not normally expected to occur. 


Contact Oracle Customer Support. 


cannot allocate variable part of SGA 

The ORACLE Database software ran out of memory. 

Increase the DYNAMIC_MEMORY and GDTSIZ parameters, and shut 
down any unnecessary processes. If this fails, decrease the size of the 
System Global Area (SGA) or Program Global Area (PGA). Refer to the 
ORACLE RDBMS Database Administrator's Guide for a discussion of INIT 
parameters that affect the size of the SGA. Refer to Chapter 8 of that 
Guide for a list of parameters that affect the PGA size. 

too many database buffers specified 


The INIT.ORA parameter DB_BLOCK_BUFFERS is too large. 


Decrease the value of DB_BLOCK_BUFFERS and retry. 
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OSD-01042: cannot allocate space for database buffers 
Cause: Out of memory. 


Action: Increase the DYNAMIC_MEMORY and GDTSIZ parameters, and shut 
down any unnecessary processes. If this fails, decrease the size of the 
System Global Area (SGA) or Program Global Area (PGA). Refer to the 
ORACLE RDBMS Database Administrator's Guide for a discussion of INIT 
parameters that affect the size of the SGA. Refer to Chapter 8 of that 
Guide for a list of parameters that affect the PGA size. 


OSD-01043: unable to allocate variable portion of PGA 
Cause: Out of memory. 


Action: Increase the DYNAMIC_MEMORY and GDTSIZ parameters, and shut 
down any unnecessary processes. If this fails, decrease the size of the 
System Global Area (SGA) or Program Global Area (PGA). Refer to the 
ORACLE RDBMS Database Administrator's Guide for a discussion of INIT 
parameters that affect the size of the SGA. Refer to Chapter 8 of that 
Guide for a list of parameters that affect the PGA size. 


OSD-01044: unable to allocate memory for context area 
Cause: Out of memory. 


Action: Increase the DYNAMIC_MEMORY and GDTSIZ parameters, and shut 
down any unnecessary processes. If this fails, decrease the size of the 
System Global Area (SGA) or Program Global Area (PGA). Refer to the 
ORACLE RDBMS Database Administrator's Guide for a discussion of INIT 
parameters that affect the size of the SGA. Refer to Chapter 8 of that 
Guide for a list of parameters that affect the PGA size. 


OSD-01045: unable to attach to variable part of SGA 
Cause: Shared memory containing a variable part of the System Global Area 
(SGA) is not available. 


Action: Verify that the SGA has been created without errors. To do this, try 
running SQL*DBA. If SQL*DBA cannot load properly, the SGA likely 
contains errors. 
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OSD-01046: 


Cause: 


Action: 


OSD-01047: 


Cause: 


Action: 


OSD-01048: 


Cause: 


Action: 


OSD-01049: 


Cause: 


Action: 


OSD-01050: 


Cause: 


Action: 


unable to attach to database buffers area of SGA 

Shared memory containing the database buffers is not available. 

Verify that the System Global Area (SGA) has been created without error. 
To do this, try running SQL*DBA. If SQL*DBA cannot load properly, the 
SGA likely contains errors. 

unable to attach to redo buffer area of SGA 

Shared memory containing the redo buffers is not available. 

Verify that the System Global Area (SGA) has been created without error. 
To do this, try running SQL*DBA. If SQL*DBA cannot load properly, the 
SGA likely contains errors. 

unable to allocate memory 

Out of memory. 

Increase the DYNAMIC_MEMORY and GDTSIZ parameters, and shut 
down any unnecessary processes. If this fails, decrease the size of the 
System Global Area (SGA) or Program Global Area (PGA). Refer to the 
ORACLE RDBMS Database Administrator's Guide for a discussion of INIT 
parameters that affect the size of the SGA. Refer to Chapter 8 of that 
Guide for a list of parameters that affect the PGA size. 

internal buffer overflow 


This is an internal error. 


Contact Oracle Customer Support. 


unable to attach to SGA: SGA does not exist 
No System Global Area (SGA) exists to connect to. 


Start up an ORACLE instance. 
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OSD-01051: 


Cause: 


Action: 


OSD-01052: 


Cause: 


Action: 


OSD-01060: 


Cause: 


Action: 


OSD-01061: 


Cause: 


Action: 


OSD-01062: 


Cause: 


Action: 


OSD-01063: 


Cause: 


Action: 


unable to attach to buffer header array in SGA 

Shared memory containing the buffer headers is not available. 

Verify that the System Global Area (SGA) has been created without error. 
To do this, try running SOL*DBA. If SQL*DBA cannot load properly, the 
System Global Area likely contains errors. 

SGA not yet valid, initialization in progress 


You attempted to connect to ORACLE during initialization. 


Wait until ORACLE has been initialized, and try again. 


unable to read file header block 
The storage media is damaged. 


Try to recover the corrupted file at the operating-system level. 


invalid file header 
A file is corrupted. 


Try to recover the corrupted file at the operating-system level. 


file size mismatch 
The file to be reused is either too large or too small. 


Specify a new file size. 


logical block size mismatch 


The logical block size of an existing file is different from the block size 
requested. 


Use matching logical block sizes. 
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OSD-01064: 


Cause: 


Action: 


OSD-01065: 


Cause: 


Action: 


OSD-01066: 


Cause: 


Action: 


OSD-01067: 


Cause: 


Action: 


OSD-01068: 


Cause: 


Action: 


OSD-01069: 


Cause: 


Action: 


unable to write to file 
A storage device is full, or the storage media is damaged. 


Verify that the device has usable storage space available. 


invalid block size requested 
This is an internal error. 


Contact Oracle Customer Support. 


Iseek() failure, unable to read from file 
The storage media is damaged. 


Try to recover the corrupted file at the operating-system level. 


read failure 
The storage media is damaged. 


Try to recover the corrupted file at the operating-system level, 


truncated read 


The database encountered an unexpected end-of-file marker. This 
situation can be caused by damaged storage media. 


Verify that the file is not damaged. If it is damaged, try to recover the 
corrupted file at the operating-system level. 


unable to open file for reuse, no more file handles 
No file handles are available to open the file. 


Increase the FILES parameter in your CONFIG.SYS file and reboot. 
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OSD-01070: unable to open file, invalid file specification 
Cause: A specified path does not exist or a filename is invalid. 


Action: Correct the path or filename. 


OSD-01071: unable to close file 
Cause: The storage media is damaged. 


Action: Try to recover the corrupted file at the operating-system level. 


OSD-01072: truncated write 


Cause: ORACLE was unable to write to the device specified. The storage device 
may be full, or may contain damaged storage media. 


Action: Verify that the device contains free space and is not damaged. 


OSD-01073: unable to create or open file, invalid file specification 
Cause: A specified path does not exist or a filename is invalid. 


Action: Correct the path or filename. 


OSD-01074: <create> option specified, file already exists 
Cause: You attempted to CREATE a database file that already exists. 


Action: Specify a new database name or use the REUSE option to write over 
existing database files. 


OSD-01075: illegal option specified 
Cause: This is an internal error. 


Action: Contact Oracle Customer Support. 
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OSD-01076: 
Cause: 


Action: 


OSD-01078: 


Cause: 


Action: 


OSD-01079: 


Cause: 


Action: 


OSD-01080: 


Cause: 


Action: 


OSD-01081: 


Cause: 


Action: 


OSD-01082: 


Cause: 


Action: 


unable to write to file, device full 
A storage device is full. 


Free up space on the storage device or specify a new device. 


logical block size too large 
The logical block size is greater than the maximum allowable size. 


Reduce the requested logical block size using the INIT.ORA parameter, 
DB_BLOCK_ SIZE. 


unable to open file for reuse, file does not exist 

A specified file does not exist. 

Use the CREATE option to create the necessary files, or verify the 
filename. 

unable to get string from file 

A specified file is corrupted. 


Try to recover the corrupted file at the operating-system level. 


unable to create or open file, no more file handles 
No file handles are available to create or open the file. 


Increase the FILES parameter in your CONFIG.SYS file and reboot. 


unable to open file, no more file handles 
No file handles are available to open the file. 


Increase the FILES parameter in your CONFIG.SYS file and reboot. 
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OSD-01090: Destination for archived log file is read-only 


Cause: The destination for an archived log file already exists and is read-only. As 
a result, the log file cannot be deleted and the current log file cannot be 
copied over it. 


Action: Change the read-only attribute of the file. 
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APPENDIX 


DB3PREP, 123PREP, 
AND ASCPREP 
ERROR MESSAGES 


his appendix lists error messages and codes specific to the DOS and 

OS/2 versions of DB3PREP, 123PREP, and ASCPREP. It also lists 
possible causes for the error messages and suggests corrective actions. 
The information in this appendix does not duplicate information in the 
Version 6.0 ORACLE RDBMS Utilities User's Guide. 


DB3PREP, 123PREP, and ASCPREP Error Messages E 





1 








DB3PREP Error Messages 


DB3PREP-001: File extension of input file must be ".DBF" 
Cause: The external file did not have the correct file extension. 


Action: Check the file and extension; if the file is actually a dBASE III file, correct 
the extension. 


DB3PREP-002: Input file is not in dBASE III format 
Cause: The external (.DBF) file is not in the correct format. 


Action: Check the file and entered filename to see if you have identified the 
wrong file. 


DB3PREP-003: Insufficient memory to examine field definitions 
Cause: Not enough memory is available to read the file. 


Action: Increase the RAM or change the configuration of your system to make 
more memory available. 


DB3PREP-004: Insufficient memory to read a record from dbf file 
Cause: Not enough memory is available to read the file. 


Action: Increase the RAM or change the configuration of your system to make 
more memory available. 


DB3PREP-005: Insufficient memory to read a block from dbt file 


Cause: Not enough memory is available to read the file. 











Action: Increase the RAM or change the configuration of your system to make 
more memory available. 
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DB3PREP-006: 


Cause: 


Action: 


DB3PREP-007: 


Cause: 


Action: 


DB3PREP-008: 


Cause: 


Action: 


DB3PREP-009: 


Cause: 


Action: 


DB3PREP-010: 


Cause: 


Action: 


Unable to create ".SQL" file 


The program cannot write the SQL command file for creating the table. 
This is an internal DB3PREP error. 


Contact to Oracle Customer Support. 


Unable to create ".CTL" file 


The program cannot write the .CTL control file for the external file. This 
is an internal DB3PREP error. 


Contact Oracle Customer Support. 


Unable to create ".DAT" file 


The program cannot write the .DAT file for the external file. This is an 
internal DB3PREP error. 


Contact Oracle Customer Support. 


Unable to read dbf file 
DB3PREP cannot read the file due to format problems. 


Examine the file to see if there are any peculiarities in its format or if it 
conforms to the guidelines for loaded dBASE III PLUS files. 


Unable to open dbf file 
The program cannot open the file. 


Either the file does not exist, or the path is incorrectly specified. Check 
these possibilities and try again. 
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DB3PREP-011: 


Cause: 


Action: 


DB3PREP-012: 


Cause: 


Action: 


DB3PREP-013: 


Cause: 


Action: 


Unable to open dbt file 
The program cannot open the file. 


Either the file does not exist, or the path is specified incorrectly. Check the 
filename and path and try again. 


Unable to read dbt file 
DB3PREP cannot read the file due to format problems. 


Examine the file to see if there are any peculiarities in its format or if it 
conforms to the guidelines for loaded dBASE III PLUS files. 


Unknown error 
Program does not recognize the error condition. 


Report the problem to Oracle Customer Support. 
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123PREP-001: 


Cause: 


Action: 


123PREP-002: 


Cause: 


Action: 


123PREP-003: 


Cause: 


Action: 


123PREP-004: 


Cause: 


Action: 


123PREP-005: 


Cause: 


Action: 


Cannot open file name 

123PREP encountered an error when trying to open the file. 

Examine the file and path specification (if any) to see if they were entered 
correctly; if there is no problem with the entry or file, this should be 
reported to Oracle Customer Support as an internal 123PREP problem. 
Could not access name in the current directory 


This is an access problem; the program cannot find the file. 


Check your path specification and then check whether the file is in the 
current directory. 


Each column in the range must have a column label 
All columns must be labelled for the load to work properly. 


Correct the file by adding missing column label(s). 


Each column name must be unique 
The program requires unique column names. 


Correct the file by changing column names so there is no duplication. 


Encountered a non-Lotus format record 
The file is not in Lotus 1-2-3 format and so cannot be processed. 


Examine the file to see what is aberrant about the format and correct it if 
possible. 
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123PREP-006: 


Cause: 


Action 


123PREP-007: 


Cause: 


Action: 


123PREP-008: 


Cause: 


Action: 


123PREP-010: 


Cause: 


Action: 


123PREP-011: 


Cause: 


Action: 


Encountered EOF before finding any data cells 


Program could not scan the file properly due to aberrant characters, 
format problems or no data. 


Examine the file and correct the problems if possible. 


Encountered invalid number for date conversion 


The dates in the file are not in standard Lotus format so the program 
cannot automatically convert them. 


Examine the file and correct the dates if possible. 


Error trying to read file name 
The program could not continue reading the file. 
There is some kind of format problem with the Lotus 1-2-3 file; check the 


file. If it follows all formatting guidelines, this may be an internal 
problem, contact Oracle Customer Support. 


Fatal error calling the subprocess name 


123PREP was unable to run SQL*Loader. The problem is probably caused 
by running out of memory. 


Change your configuration to increase the amount of available memory, 
then try again. If the problem reappears, notify Oracle Customer Support. 
Input file must have a.WKS or .WK1 extension 

You have entered an incorrect extension. 


Correct the entry (only WKS for Release 1, or WKI for Release 2, are 
allowed). 
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123PREP-012: 


Cause: 


Action: 


123PREP-013: 


Cause: 


Action: 


123PREP-014: 


Cause: 


Action: 


123PREP-015: 


Cause: 


Action: 


123PREP-016: 


Cause: 


Action: 


123PREP-017: 


Cause: 


Action: 


Input file not in Lotus format 
The file is not in standard Lotus 1-2-3 format. 


Check the file and correct format problems if necessary. Check that this is 
actually a Lotus file. 


Input file not in Lotus Release n format 

The file to be loaded is not in the correct format for the entered version. 
Correct the entered extension to reflect the correct version number of 
Lotus 1-2-3. 

File has no data in it 

The main range has no columns 


Examine the file and correct the format. 


Not enough memory available 

There is insufficient memory to load the files. 

Increase the available memory either by adding RAM or changing your 
configuration. 

Range name does not exist in the worksheet 

The named range for translation cannot be found in the file. 


Check your entry or the file for the correct name. 


The -c and -d options may not be used together 


The program rejected the load command because it includes both the “-C” 
and “-D” options. 


Delete one of the options and resubmit the load. 
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123PREP-018: 
Cause: 


Action: 


123PREP-019: 


Cause: 


Action: 


123PREP-020: 


Cause: 


Action: 


123PREP-021: 


Cause: 


Action: 


The first row of text must contain column labels only 
The program requires the first row to contain column labels. 


Examine the file and correct it by adding column labels. 


Unable to update file name 


The program encountered an error when opening the SQL or .CTL file. 
This is an internal problem. 


Notify Oracle Customer Support. 


Unknown cell in data section 
The program encountered a non-Lotus data cell within the file. 


The file has been corrupted in some way; examine it and see if you can 
recover or delete the bad data. 


Unknown error 
Program does not recognize the error condition. 


Report the problem to Oracle Customer Support. 
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ASCPREP Error Messages 


ASCPREP-001: 
Cause: 


Action: 


ASCPREP-002: 


Cause: 


Action: 


ASCPREP-003: 


Cause: 


Action: 


ASCPREP-004: 
Cause: 


Action: 


ASCPREP-005: 


Cause: 


Action: 


Cannot open file name 
The program cannot enter the file to read it. 


Check whether the file exists or the path specification was correct. 


Could not access name in the current directory 
The path specification for the file is incorrect. 


Check the path specification and correct it. 


Encountered unexpedited end-of-file in name 
The program cannot read the data in the ASCII file. 


Examine the ASCII file and correct the problem. 


Fatal error calling the subprocess name 
SQL*Loader is not working, probably due to insufficient memory. 


Reconfigure your system to increase the memory and try again; if the 
problem persists, contact Oracle Customer Support. 


Not enough memory to process this file 
The file is too large to write into current storage parameters. 


Increase the storage parameters. 
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ASCPREP-006: 


Cause: 


Action: 


ASCPREP-007: 


Cause: 


Action: 


ASCPREP-008: 


Cause: 


Action: 


ASCPREP-009: 


Cause: 


Action: 


ASCPREP-010: 


Cause: 


Action: 


Table name does not exist in the database 


The program cannot find a table with the specified name from which to 
read column names. 


Create the table or (if the table exists), check the tablename; perhaps you 
forgot to specify a different name from the filename. 

The -c and -d options may not be used together 

The “-C” and “-D” options are mutually exclusive. 


In the command, delete one of the options and run the load again. 


Unable to retrieve column info for table name 
The program cannot open the external file to retrieve the data. 


Check the external file format. If it conforms to rules for loading, this may 
be an internal error; notify Oracle Customer Support. 


Unable to log on to the ORACLE database 
The program cannot log onto ORACLE during its operation. 
You have either entered an invalid username / password, or the ORACLE 


database is shut down. Check whether ORACLE is running, and then 
re-enter the command. 


Unable to update file name 
The program cannot create the control file. 


Check your entry for invalid parameters and re-enter. 
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ASCPREP-011: 


Cause: 


Action: 


Warning: Fields in data file do not match table columns 
The number of columns in the table does not match the number of fields 
in the external file. 


Examine both the table and file to find out where the discrepancy lies. 
You can either create a new column in the table or delete one of the fields 
in the ASCII file so that the numbers match. 
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Adding database files 6-9 to 6-10 
Alert files 
limitations under DOS A-3 
ALTER TABLESPACE statement 6-9 to 6-10 
AMERICAN_AMERICA.US7ASCII 
parameter 4-14 
Applications 
optional changes for upgrading 4-14 
required changes for upgrading 4-12 
Archive destination 
specifying 7-3, 7-6 
ARCHIVE LOG statement 7-4 
DOS limitation of 7-3 
ARCHIVELOG mode 7-2, 7-4 
Archiving redo-log files 7-2 to 7-4, 7-6 to 7-7 
DOS considerations of 7-3 
DOS errors with 7-4 
enabling 7-6 
to tape 7-2, 7-4, 7-6 
ASCII files 
AUTOEXEC.BAT 3-14 
CONFIG.ORA 5-8, 5-12 
CONFIG.SYS 3-12 to 3-13 
INIT.ORA 5-8 
loading into database 11-13 


ASCPREP utility 
command syntax 11-16 
date conversion 11-13 
delimited files 11-13 
delimiter values 11-19 
DESC command 11-20 
editing control file 11-20 
examples 11-22 
file limitations 11-13 
installing 3-11 
memory requirements of 2-2 
options 11-18 
preparation of files 11-13 
record length 11-13 
records 11-13 
sample ASCII file 11-14 
sample load 11-20 
Authorization password 3-10, 5-4 to 5-5 
AUTOEXEC.BAT file 
errors in 3-15 
modifying 3-4, 3-6, 3-14 
AUTOEXEC.NEW file 3-6 
Automatic archiving 7-3 to 7-4, 7-6 to 7-7 
disabling under DOS 7-4 
enabling under DOS 7-3 
errors with DOS 7-4 to 7-5 
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BACKGROUND_DUMP_DEST parameter 
10-6 
Backing up 
database files 7-9 
preparation for 7-2 to 7-4, 7-6 
redo-log files 7-2 to 7-4, 7-6 to 7-7 
Backups 
offline 7-6, 7-9 
online 7-9 
requiring HOST statement 7-9 
using OCOPY 7-9 
\BIN subdirectory 3-3 
Bind array limit in SQL*Loader 11-2 
BINDSIZE parameter 11-2 
BREAK parameter 3-12 
BUFFERS parameter 3-12 


C 


Caches 
See Disk caches 
CALLS parameter 10-6 
CATALOG.SQL file 6-4, 6-8 
CATALOGS.SQL file 6-6 
Changing DBA authorization password 5-4 
Checking storage space 6-9 
in Version 5.1 database 4-7 
Client manager 1-4 
CONFIG file 9-1 to 9-4, 9-6, 9-8 to 9-11 
CONFIG_FILE parameter 9-4 


DBA_AUTHORIZATION parameter 3-10, 5-5 


DYNAMIC_MEMORY parameter 5-9, 9-4 
GDTSIZ parameter 9-4 

INTERRUPT parameter 9-5 

LANGUAGE 9-5 

LOCAL parameter 9-6 

MACHTYPE parameter 9-6 
MISSING_CONFIG_ERROR parameter 9-7 
modifying parameters in 9-2 to 9-3 


ORACLE_ARCH_COMMAND parameter 7-7 


ORACLE_TIO parameter 9-2 
ORACLE_DBS parameter 9-7 
ORACLE_HOME parameter 9-7 
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ORACLE_MSG parameter 9-7 
ORACLE_SPOOLER parameter 9-8 
ORACLE_TIO parameter 9-8 
REAL_MEMORY parameter 9-9 
REMOTE parameter 9-10 
setting parameters 9-2 to 9-3 
SQLNET parameter 9-10 
temporary modifications to 4-3, 4-8 
USERNAME parameter 9-10 
UTILITY_MSG parameter 9-3, 9-11 
XMMITR parameter 9-11 
CONFIG parameter 
See CONFIG_FILE parameter 
CONFIG.NEW file 3-6 
CONFIG.SYS file 
errorsin 3-15 
modifications under DOS 3-12 
modifications under OS/2 3-12 
CONFIG_FILE parameter 3-13 to 3-14, 9-4 
CONNECT INTERNAL statement 6-5 
Contention tuning 8-5 
CONTEXT_AREA parameter 10-6 
CONTEXT_INCR parameter 10-6 
CONTROL_FILES parameter 6-4, 10-2, 10-6 
Conventions 
See Preface 
CPU_COUNT parameter 10-6 
CREATE DATABASE statement 6-5 
default results of 6-8 
CREATE INDEX statement 4-14 
CREATE PARTITION statement 4-5 
CREATE ROLLBACK SEGMENT statement 
4-10 
CREATE SPACE DEFINITION statement 4-5 
CREATE TABLE statement 4-5, 4-14 
CREATE TABLESPACE statement 4-8 
Creating database files 6-2 to 6-10 
key INIT parameters 6-3 to 6-4 
CTE file 11-5, 11-7, 11-9 
Customizing INIT files 10-4 























D 


Data storage 6-9 
Database 
definition of i-iv 
See ORACLE Database 
Database administration 5-2 
backing up the database 7-1 to 7-4, 7-6 to 7-7, 
7-9, 10-4 
checking database size 6-9 
controlling database parameters 10-1 to 10-6 
controlling operating-system parameters 
9-1 to 9-4, 9-6 to 9-11 
creating database files 6-1 to 6-9 
expanding the database 6-9 to 6-10 
recovering database files 7-9 
responsibilities of DBA 5-2 
setting up user accounts 5-13 to 5-14 
starting ORACLE 5-8 to 5-9, 5-12 
stopping ORACLE 5-9, 5-11 to 5-12 
tuning database performance 8-1 to 8-7 
See also SQL*DBA utility 
Database administrator (DBA) 
responsibilities of 5-2 
See also Database administration 
Database files 
backing up 7-9 
initial database 6-2 
recovering 7-9 
DB_BLOCK_BUFFERS parameter 10-3 
DB_FILE_MULTIBLOCK_READ_ COUNT 
parameter 10-3, 10-6 
DB_NAME parameter 6-3, 10-3 
DB3LOAD command 11-6 
DB3PREP utility 11-3 
installing 3-11 
sample output 11-4 
DB_BLOCK BUFFERS parameter 10-4, 10-6 
DB_BLOCK_COMPUTE_CHECKSUM 
parameter 10-6 
DB_BLOCK_HASH_BUCKETS parameter 
10-6 
DB_BLOCK_SIZE parameter 10-3, 10-6 
DB_NAME parameter 10-3 to 10-4 
DBA 
See Database administrator (DBA) 


DBA_AUTHORIZATION parameter 3-10, 5-5 
DBA_SYNO.SQL file 4-14 
DBAPWD utility 5-4 
dBASE III Plus multiple memo fields 11-3 
\DBS subdirectory 3-3 
DC_COLUMN_GRANTS parameter 
10-3, 10-6 
DC_COLUMNS parameter 10-3, 10-6 
DC_CONSTRAINT_DEFS parameter 
10-3, 10-6 
DC_CONSTRAINTS parameter 10-3, 10-6 
DC_FILES parameter 10-3, 10-6 
DC_FREE_EXTENTS parameter 10-3, 10-6 
DC_INDEXES parameter 10-3, 10-6 
DC_OBJECT_IDS parameter 10-3, 10-6 
DC_OBJECTS parameter 10-3, 10-6 
DC_ROLLBACK_SEGMENTS parameter 
10-3, 10-6 
DC_SEGMENTS parameter 10-4, 10-6 
DC_SEQUENCE GRANTS parameter 
10-4, 10-6 
DC_SEQUENCES parameter 10-4, 10-6 
DC_SYNONYMS parameter 10-4, 10-6 
DC_TABLE_GRANTS parameter 10-4, 10-6 
DC_TABLES parameter 10-4, 10-6 
DC_TABLESPACE QUOTAS parameter 
10-4, 10-6 
DC_TABLESPACES parameter 10-4, 10-6 
DC_USED_EXTENTS parameter 10-4, 10-6 
DC_USERNAMES parameter 10-4, 10-6 
DC_USERS parameter 10-4, 10-6 
DDL_LOCKS parameter 10-3 to 10-4, 10-6 
Default database 6-8 
Definition of filespec 6-6 
DESC command 11-20 
Directories 
\BIN 3-3 
\DBS 3-3 
\DLL 3-3 
\LOADER 3-3 
\ORACLE6 3-3 
\PBIN 3-3 
ASRW 3-3 
Disabling automatic archiving 
under DOS 7-4 
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Disk caches 8-6 to 8-7 
write caches 8-6 
Disk-space requirements 2-2, 2-5 
for upgrading to ORACLE Database V6.0 2-6 
Disks included with ORACLE Database for 
DOS 1-5 
Disks included with ORACLE Database for 
OS/2 1-5 
\DLL subdirectory 3-3 
DML_LOCKS parameter 10-4, 10-7 
Documentation included with ORACLE 
Database product 1-5 
DOS 
AUTOEXEC.BAT file 3-6, 3-14 
CONFIG.SYS file 3-6, 3-12 
definition of i-iv 
extended memory support 2-1 
limitations 11-2, A-1 
PATH command 3-14 
types of memory supported with 2-3 
DR DOS 
SHARE.EXE and open files A-2 
DROP TABLE SQL statement 4-5 
DROPCATS.SQL script 4-7 
DYNAMIC MEMORY parameter 2-4, 5-9, 9-4 
and expanded memory managers 5-9 


E 


Enabling automatic archiving 
7-3 to 7-4, 7-6 to 7-7 

under DOS 7-3 to 7-4 
ENQUEUE_RESOURCES parameter 6-4, 
10-3, 10-7 
ERRLVL utility 7-7 
Error detection 

during installation 3-15 

in C language 7-8 

in ORA_ARCH.CMD file 7-8 
Error messages and codes B-1, C-1 

documentation included for 1-5 
EXIT command 5-3 
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EXP utility 3-4 
cumulative exports 4-15 
description of 1-3 
incremental exports 4-15 
installing 3-9 
memory requirements 2-2 
requirements of 2-2, 2-5 
upgrading applications for 4-15 
Expanded memory 
definition of 2-3 
using ORACLE with 2-4 
See also Expanded memory managers 
Expanded memory managers 
and DYNAMIC_MEMORY parameter 5-9 
compatibility with ORACLE 2-4 
selecting as machine type 2-4, 3-8, 5-9 
VCPI standard 2-4 
Expanding the database 6-9 to 6-10 
Export utility 
See EXP utility 
Extended memory 
definition of 2-3 
requirements for 2-2 
SQLPME and 2-3 
support for 2-1 


F 


FILES parameter 3-12 
filespec 
use in ALTER TABLESPACE 6-9 
use in CREATE DATABASE 6-5 
Free space 6-9 


G 


GDTSIZ parameter 2-4, 9-4 
and SQLPME requirements 2-4 
GRANT statement 5-13 to 5-14 


H 


Hardware requirements 2-2, 2-5 
Help 3-5 
HOST statement 5-3, 7-9 
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IMP utility 
and Version 5.1 partitions 4-4 
cluster indexes and 4-11 
description of 1-3 
installing 3-9 
memory requirements 2-2 
requirements of 2-2, 2-5 
upgrading applications for 4-15 
Version 5.1 partitions and 4-4 
Version 6.0 structures and 4-11 
Import utility 
See IMP utility 
INIT (file) 
big sample 10-5 
changing parameters 10-2 
CONFIG.ORA file and 3-6, 9-5 
initial 10-4 
LANGUAGE parameter 3-6, 9-5 
medium sample 10-5 
modifying 3-6, 9-5 
parameter list 10-5 
parameters involved in database creation 
6-3 to 6-4 
small sample 10-4 
INIT (parameter) 
BACKGROUND_DUMP_DEST 10-6 
CALLS 10-6 
CONTEXT_AREA 10-6 
CONTEXT_INCR 10-6 
CONTROL_FILES 10-2, 10-6 
CPU_COUNT 10-6 
DB_FILE_MULTIBLOCK_READ_ COUNT 
10-6 
DB_BLOCK_BUFFERS 10-3 to 10-4, 10-6 
DB_BLOCK_COMPUTE_CHECKSUM 10-6 
DB_BLOCK_HASH_BUCKETS 10-6 
DB_BLOCK_SIZE 10-3, 10-6 
DB_FILE_MULTIBLOCK_READ_COUNT 
10-3 
DB_NAME 10-3 to 10-4 
DC_COLUMN_GRANTS 10-3, 10-6 
DC_COLUMNS 10-3, 10-6 
DC_CONSTRAINT_DEFS 10-3, 10-6 
DC_CONSTRAINTS 10-3, 10-6 


DC_FILES 10-3, 10-6 
DC_FREE_EXTENTS 10-3, 10-6 
DC_INDEXES 10-3, 10-6 
DC_OBJECT_IDS 10-3, 10-6 
DC_OBJECTS 10-3, 10-6 
DC_ROLLBACK_SEGMENTS 10-3, 10-6 
DC_SEGMENTS 10-4, 10-6 
DC_SEQUENCE_GRANTS 10-4, 10-6 
DC_SEQUENCES 10-4, 10-6 
DC_SYNONYMS 10-4, 10-6 
DC_TABLE_GRANTS 10-4, 10-6 
DC_TABLES 10-4, 10-6 
DC_TABLESPACE_QUOTAS 10-4, 10-6 
DC_TABLESPACES 10-4, 10-6 
DC_USED_EXTENTS 10-4, 10-6 
DC_USERNAMES 10-4, 10-6 
DC_USERS 10-4, 10-6 
DDL_LOCKS 10-3 to 10-4, 10-6 
DML_LOCKS 10-4, 10-7 
ENQUEUE_RESOURCES 10-3, 10-7 
INIT_SQL_FILES 6-4, 10-7 
LANGUAGE 4-14 
LOC_ALLOCATION 10-3 
LOG_ALLOCATION 10-4 
LOG_ARCHIVE_DEST 10-7 
LOG_ARCHIVE_START 10-7 
LOG_BLOCKS_DURING_BACKUP 10-7 
LOG_BUFFER 10-4, 10-7 
LOG_CHECKPOINT_INTERVAL 10-4, 10-7 
LOG_ENTRY_PREBUILD_THRESHOLD 10-7 
LOG_FILES 10-7 
LOG_IO_SIZE 10-7 
LOG_SIMULTANEOUS COPIES 10-7 
LOG_SMALL_ENTRY_MAX_ SIZE 10-7 
OPEN_CURSORS 10-2 
PROCESSES 10-4, 10-7 
ROLLBACK_SEGMENTS 10-3 to 10-4 
ROW_CACHE_ENQUEUES 10-4, 10-7 
ROW_LOCKING 10-3, 10-7 
SEQUENCE CACHE ENTRIES 10-4, 10-7 
SEQUENCE CACHE HASH BUCKETS 
10-4, 10-7 
SESSIONS 10-7 
SORT_AREA_SIZE 10-7 
SORT_READ_FAC 10-7 
SORT_SPACEMAP SIZE 10-7 
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TRANSACTIONS 10-3, 10-7 
TRANSACTIONS _PER_ROLLBACK_ 
SEGMENT 10-7 
USE_ROW_ENQUEUES 10-3 
USER_DUMP_DEST 10-7 
INIT.ORA file 
See INIT (file) 
INIT_SQL_FILES parameter 6-4, 10-7 
INITBIG.ORA file 10-5 
Initial database 
description of 6-2 
installation of 3-10 
INITMED.ORA file 10-5 
INITSML.ORA file 10-4 
Installation 
errorsin 3-4, 3-15 
help during 3-5 
initial database 3-10 
instructions 3-2 to 3-5 
national language support 3-6 
ORACLE Database 3-10 
ORACLE utilities 3-9 
overview of 3-2 
Required Support Files 3-7 
SQL*Loader 3-11 
update disk 3-16 
verifying 3-16 
Installation program 
See ORAINST utility 
Instances 6-5 
INTERRUPT parameter 9-5 
Interrupting SQL*DBA sessions 5-3 


L 


LANGUAGE parameter 4-14, 9-5 
INIT.ORA and CONFIG.ORA files 3-6, 9-5 
modifying 3-6 
LIBPATH parameter 4-3, 4-8 
Limitations under DOS A-2 to A-3 
Limitations under OS/2 A-5 
Listing installed products 3-16 
\LOADER subdirectory 3-3 
LOCAL parameter 9-6 
Log sequence number 7-3, 7-6 
LOG_ALLOCATION parameter 10-3 to 10-4 
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LOG_ARCHIVE_DEST parameter 
7-3, 7-6, 10-7 
LOG_ARCHIVE START parameter 7-3, 10-7 
DOS use of 7-3 
LOG_BLOCKS_DURING BACKUP 
parameter 10-7 
LOG_BUFFER parameter 10-4, 10-7 
LOG_CHECKPOINT_INTERVAL parameter 
10-4, 10-7 
LOG_ENTRY_PREBUILD_THRESHOLD 
parameter 10-7 
LOG_FILES parameter 10-7 
LOG_IO_SIZE parameter 10-7 
LOG_SIMULTANEOUS_COPIES parameter 
10-7 
LOG_SMALL_ENTRY_MAX_SIZE 
parameter 10-7 
Lotus 1-2-3 
using 123PREP 11-7, 11-9 to 11-10 
spreadsheets 11-7, 11-11 
translating guidelines 11-8 
using 1-2-3 11-11 
versions supported 11-7 


M 


Machine type 
selecting VCPI standard 2-4 
MACHTYPE parameter 9-6 
MACHTYPE utility 3-7 to 3-8 
selecting expanded memory managers 
2-4, 3-8, 5-9 
selecting VCPI standard 2-4, 3-8, 5-9 
using 2-4 
Manual archiving 
limitations under DOS 7-3, A-3 
OS/2 support for 7-6 
MAXDATA parameter 
limitations under DOS A-4 
Memory 
expanded 2-3 
extended 2-3 
real 2-3 











Memory requirements 2-2 

for ASCPREP utility 2-2 

for EXP utility 2-2 

for IMP utility 2-2 

for ORACLE Database for MS-DOS 2-2 

for ORACLE Database for OS/2 2-5 

for OS/2 2-5 

for SQL*DBA utility 2-2 

for SQLPME 2-2 to 2-3 

for TKPROF utility 2-2 

for upgrading to ORACLE Database V6.0 2-6 
Memory-management software 

SQLPME as 2-3 

using ORACLE with 2-4 
MISSING_CONFIG_ERROR parameter 9-7 
MONITOR statement 5-6 to 5-7, 8-4 
MONO option 3-5 
MS-DOS 

SHARE.EXE and open files A-2 
Multiple logons 

limitations under DOS A-3 
Multiple-process database 8-3 


N 


National language support 

ORAINST and 3-6 
Nested logons 

limitations under DOS A-3 
NLS 

See National language support 
NOARCHIVELOG mode 7-2 
Notational conventions 

See Preface 


O 


OCOPY utility 7-9 
ODL script 
upgrading 4-12 
ODL2LDR utility 4-12 
Offline redo-log file 7-6 
123PREP utility 
installing 3-11 
OPEN_CURSORS parameter 10-2 


OPS$ account 5-14 
ORA_ARCH.CMD file 7-7 
ORACLE 
limitation under OS/2 A-5 
limitations under DOS A-3 
ORACLE Database 
definition of i-iv 
description of 1-2 
directory structure 3-3 
documents included with 1-5 
installing 3-2 to 3-11, 3-15 
national language support 3-6 
requirements of 2-2, 2-5 to 2-6 
single-user versions of 1-2 
upgrading 4-1 to 4-10, 4-12 to 4-15 
See also Database administration 
ORACLE Database product 
contents of 1-5 
description of 1-3 
directory structure of 3-3 
disks included with DOS version 1-5 
disks included with OS/2 version 1-5 
documents included with 1-5 
installation of 3-2, 3-4 
See also ORACLE Database 
See also ORACLE Tools 
ORACLE RDBMS 
definition of i-iv 
ORACLE Tools 
contents of product 1-4 
description of 1-4 
learning about 1-5 
listing 3-16 
product contents 1-5 
removing 3-16 
updating 3-16 
ORACLE Utilities 
description of 1-3 
disk space requirements 2-2 
documentation included for 1-5 
installing 3-9 
memory requirements 2-2 
\ORACLE6 directory structure 3-3 
ORACLE_ARCH.CMD file 7-7 
ORACLE_ARCH_COMMAND parameter 7-7 
ORACLE_TIO parameter 5-7, 9-2 
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ORACLE DBS parameter 9-7 
ORACLE HOME parameter 9-7 
ORACLE_MSG parameter 9-7 
ORACLE SPOOLER parameter 9-8 
ORACLE TIO parameter 9-8 
ORAINST 
version requirements 3-5 
ORAINST utility 3-4 
description of 3-16 
MONO option 3-5 
requirements of 3-4 
OS/2 
CONFIG.SYS file 3-12 to 3-13 
versions supported 2-5 


P 


Partitions 

and Version 6.0 tablespaces 4-4 
Password utility 5-4 
Passwords 

regranting 4-7 

system administration and 5-13 
PATH parameter 3-13 to 3-14, 4-3, 4-8 


with protected- and real-mode software 3-14 


\PBIN subdirectory 3-3 
Performance tuning 8-1 to 8-5 
applications and 8-6 
contention and 8-5 
single-user considerations of 8-4 to 8-5 
SQL statements and 8-6 
Prefix ID 5-11 
PROCESSES parameter 10-4, 10-7 
Programmatic interfaces 
upgrading 4-15 
Protected mode 9-9 
definition of 2-3 
disk space requirements 2-2 
memory requirements 2-2 
mode used with both installed 3-14 
\PBIN subdirectory 3-3 
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R 


RDBMS 
definition of 1-2 
See ORACLE RDBMS 
See also ORACLE Database 
Real mode 
\BIN subdirectory 3-3 
definition of 2-3 
disk space requirements 2-2 
memory requirements 2-2 
mode used with both installed 3-14 
SQLPME and limits of 2-3 
REAL_ MEMORY parameter 9-9 
Redo-log file 
archiving 7-2 to 7-4, 7-6 to 7-7 
archiving to tape 7-2, 7-4, 7-6 
log sequence number of 7-3, 7-6 
Reinstalling caution 3-2, 3-4 
Relational Database Management System 
(RDBMS) 
definition of 1-2 
See also ORACLE Database 
REMORA command 5-10 
ALL option 5-10 
LIST option 5-10 
PREFIXID option 5-10 
REMOTE parameter 9-10 
Removing installed products 3-16 
Required support files 2-4 
installing 3-7 
Requirements 
hardware and software for DOS 2-2 
hardware and software for OS/2 2-5 
Rollback segments 6-2 
creating and activating 6-8 
SYSTEM 6-8 
ROLLBACK_SEGMENTS parameter 
10-3 to 10-4 
Row-level locking 
modifying application for 4-14 
ROW_CACHE_ENQUEUES parameter 
10-4, 10-7 
ROW_LOCKING parameter 10-3, 10-7 











S 


-s option 2-3 
S: prefix ID 5-11 
Savepoints 4-14 
Segments 
and upgrading to ORACLE V6.0 4-9 
where to find information about 4-2 
SEQUENCE generation 4-14, 8-5 
SEQUENCE_CACHE_ENTRIES parameter 
10-4, 10-7 
SEQUENCE_CACHE_HASH_BUCKETS 
parameter 10-4, 10-7 
SESSIONS parameter 10-7 
SET AUTHORIZATION statement 5-5 
abbreviation of 5-5 
SET INSTANCE statement 5-6 
SET TRANSACTION statement 4-14 
Setting SQL*DBA authorization password 5-5 
SHOW PARAMETER statement 10-5 
SHUTDOWN statement 5-10 
Single-process database 
considerations of 8-4 to 8-5 
definition of 8-2 
Single-task database 
considerations of 8-4 to 8-5 
definition of 8-2 
Single-user database 
considerations of 8-4 to 8-5 
sample INIT.ORA 10-4 
Software requirements 2-5 
Software requirements 2-2, 2-5 
SORT_AREA SIZE parameter 10-7 
SORT_READ_FAC parameter 10-7 
SORT_SPACEMAP SIZE parameter 10-7 
SQL 
description of 1-2 
See also SQL*Plus 
SQL file 11-4, 11-7, 11-9 
sample output 11-4 
SQL trace facility 8-4 
SOL*DBA commands 
limitations under DOS A-4 


SQL*DBA utility 
authorization password for 5-4 to 5-5 
changing passwords with 5-13 
CONNECT INTERNAL statement 6-5 
description of 1-3 
HOST statement 5-3, 7-9 
installation message for 3-9 
installing authorization password for 3-10 
MONITOR statement 5-6 to 5-7, 8-4 
quitting 5-2 
requirements of 2-2, 2-5 
SHUTDOWN statement 5-10 
starting 5-2 
using remote database with 5-6 
SQL*Forms 
description of 1-2, 1-4 
SQL*Loader utility 
ASCII files 11-13 
ASCII limitations 11-13 
ASCPREP command 11-13, 11-16 
bind array limit 11-2 
BINDSIZE parameter 11-2 
converting ODL control files 4-12 
description of 1-3 
documentation included for 1-5 
features 11-2 
installing 3-11 
\LOADER subdirectory 3-3 
options parameter 11-9 
product description 11-2 
requirements of 2-2, 2-5 
updating scripts from ODL 4-12 
using 11-1 
using with dBASE III PLUS files 11-3 
using with Lotus 1-2-3 files 11-7 
SQL*Menu 
description of 1-4 
SQL*Net 5-10 
SQL*Plus 
accessing SQL with 1-2 
CTE file 11-7 
description of 1-2, 1-4 
‚SQL file 11-9 
SQL*ReportWriter 
description of 1-4 
SQL.BSQ file 6-4 
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SQLNET parameter 9-10 
SQLPME utility 
and GDTSIZ parameter 2-3 
definition of 2-3 
description of 2-3 
disk-space requirements 2-3 
memory requirements 2-3 
removing from RAM 5-11 
requirements of 2-2 
-s option 2-3 
starting 2-3 
using with other memory managers 2-4 
Starting instances 6-5 
Starting ORACLE with memory managers 5-9 
Storage space 6-9 
Structured Query Language 
See SQL 
Subdirectories 3-3 
SYS account 
changing password for 5-13 
tables 4-13 
SYS.DUAL 4-13 
SYSTEM account 
changing password for 5-13 
System administration 
See Database administration 
System Global Area (SGA) 8-6 
SYSTEM rollback segment 6-8 
SYSTEM tablespace 6-8 
System-privileged commands 5-4 
SYSTEM.DUAL 4-13 
SYSTEM_RS rollback segment 6-2 


T 


Tables 
upgrading 4-10 
Tablespaces 6-2 
and Version 5.1 partitions 4-4 
initial database 6-2 
where to find information about 4-2 
Tape drives 7-2, 7-4, 7-6 
Terminate and Stay Resident (TSR) programs 
3-4, 3-15 
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Oracle Corporation welcomes your comments and suggestions on the quality and usefulness of this 
publication. Your input is an important part of the information used for revision. 


e Did you find any errors? 

e Is the information clearly presented? 

e Do you need more information? If so, where? 

e Are the examples correct? Do you need more examples? 
e What features did you like most about this document? 


If you find any errors or have any suggestions for improvement, please indicate the topic, chapter, 
and page number below: 
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Desktop Products Division 
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500 Oracle Parkway 

Redwood Shores, CA 94065 
415.506.7000 


If you would like a reply, please write your name, address, and telephone number below: 
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